Robin: AI-Powered Dark Web OSINT Tool

Robin is an AI-powered tool for conducting dark web OSINT investigations. It leverages LLMs to refine queries, filter search results from dark web search engines, and provide an investigation summary.

Installation • Usage • Contributing • Acknowledgements

• ⚙️ Modular Architecture – Clean separation between search, scrape, and LLM workflows.
• 🤖 Multi-Model Support – Easily switch between OpenAI, Claude, Gemini or local models like Ollama.
• 💻 CLI-First Design – Built for terminal warriors and automation ninjas.
• 🐳 Docker-Ready – Optional Docker deployment for clean, isolated usage.
• 📝 Custom Reporting – Save investigation output to file for reporting or further analysis.
• 🧩 Extensible – Easy to plug in new search engines, models, or output formats.
• 🔄 Modern Python Packaging – Uses src layout and pyproject.toml for better maintainability
• ⚡ uv Support – Fast Python package management and execution support

This tool is intended for educational and lawful investigative purposes only. Accessing or interacting with certain dark web content may be illegal depending on your jurisdiction. The author is not responsible for any misuse of this tool or the data gathered using it.

Use responsibly and at your own risk. Ensure you comply with all relevant laws and institutional policies before conducting OSINT investigations.

Additionally, Robin leverages third-party APIs (including LLMs). Be cautious when sending potentially sensitive queries, and review the terms of service for any API or model provider you use.

docker run --rm \
   -v "$(pwd)/.env:/app/.env" \
   --add-host=host.docker.internal:host-gateway \
   -p 8501:8501 \
   apurvsg/robin:latest web --ui-port 8501 --ui-host 0.0.0.0

# Install uv if not already installed
pip install uv

# Install and run the project
uv sync
uv run robin --help

• Download the appropriate binary for your system from the latest release
• Unzip the file, make it executable

chmod +x robin

• Run the binary as:

robin cli --model gpt-4.1 --query "ransomware payments"

Robin: AI-Powered Dark Web OSINT Tool

options:
  -h, --help            show this help message and exit
  --version             show the version and exit
  --model {gpt4o,gpt-4.1,claude-3-5-sonnet-latest,llama3.1,gemini-2.5-flash}, -m {gpt4o,gpt-4.1,claude-3-5-sonnet-latest,llama3.1,gemini-2.5-flash}
                        Select LLM model (e.g., gpt4o, claude sonnet 3.5, ollama models, gemini 2.5 flash)
  --query QUERY, -q QUERY
                        Dark web search query
  --threads THREADS, -t THREADS
                        Number of threads to use for scraping (Default: 5)
  --output OUTPUT, -o OUTPUT
                        Filename to save the final intelligence summary. If not provided, a filename based on the
                        current date and time is used.

Commands:
  cli  Run Robin in CLI mode.
  web  Run Robin in Web UI mode.

Example commands (using uv):
 - uv run robin cli -m gpt4o -q "ransomware payments" -t 12
 - uv run robin cli --model claude-3-5-sonnet-latest --query "sensitive credentials exposure" --threads 8 --output filename
 - uv run robin cli -m llama3.1 -q "zero days"
 - uv run robin cli -m gemini-2.5-flash -q "zero days"
 - uv run robin web --ui-port 8501 --ui-host localhost

This fork introduces modern Python packaging practices while preserving all original functionality:

• src layout: All Python code is now in src/robin/ directory for better project organization
• pyproject.toml: Uses hatchling build backend with comprehensive dependency management
• uv support: Optimized for fast package management and execution using uv
• Docker improvements: Updated to work with new project structure and use uv for dependency installation
• Import compatibility: Updated import statements to work in both module and direct script contexts

The project now fully supports uv for fast dependency management and execution:

# Install dependencies quickly
uv sync

# Run to get help
uv run robin --help
# Run CLI ui directly with uv
uv run robin cli [options]

# Run the Web UI directly with uv
uv run robin web

Contributions are welcome! Please feel free to submit a Pull Request.

• Fork the repository
• Create your feature branch (git checkout -b feature/amazing-feature)
• Commit your changes (git commit -m 'Add some amazing feature')
• Push to the branch (git push origin feature/amazing-feature)
• Open a Pull Request

Open an Issue for any of these situations:

• If you spot a bug or bad code
• If you have a feature request idea
• If you have questions or doubts about usage

Original Author: Apurv Singh Gautam - Original creator and maintainer of Robin

• Idea inspiration from Thomas Roccia and his demo of Perplexity of the Dark Web.
• Tools inspiration from the original OSINT Tools for the Dark Web repository.
• LLM Prompt inspiration from OSINT-Assistant repository.
• Logo Design by Tanishq Rupaal

Fork Changes: This fork introduces modern Python packaging (src layout, pyproject.toml), uv support, and improved Docker configuration while maintaining all original functionality and credits to the original author.