https://github.com/apurvsinghgautam/robin
AI-Powered Dark Web OSINT Tool
https://github.com/apurvsinghgautam/robin
ai-tool darkweb darkweb-osint investigation-tool llm-powered osint osint-tool
Last synced: 4 months ago
JSON representation
AI-Powered Dark Web OSINT Tool
- Host: GitHub
- URL: https://github.com/apurvsinghgautam/robin
- Owner: apurvsinghgautam
- License: mit
- Created: 2025-04-08T14:20:34.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-11T05:25:17.000Z (4 months ago)
- Last Synced: 2026-02-11T12:15:36.195Z (4 months ago)
- Topics: ai-tool, darkweb, darkweb-osint, investigation-tool, llm-powered, osint, osint-tool
- Language: Python
- Homepage:
- Size: 27 MB
- Stars: 4,177
- Watchers: 43
- Forks: 800
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ai-osint - Robin:AI-Powered Dark Web OSINT Tool
- Awesome-OSINT-List - robin - AI-Powered Dark Web OSINT Tool for investigation and analysis. (DARKNET / URL's)
- starred - apurvsinghgautam/robin - AI-Powered Dark Web OSINT Tool (Python)
- AiTreasureBox - apurvsinghgautam/robin - 01-09_3525_3](https://img.shields.io/github/stars/apurvsinghgautam/robin.svg)|AI-Powered Dark Web OSINT Tool| (Repos)
- StarryDivineSky - apurvsinghgautam/robin
README
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
---
## Features
- ⚙️ **Modular Architecture** – Clean separation between search, scrape, and LLM workflows.
- 🤖 **Multi-Model Support** – Easily switch between OpenAI, Claude, Gemini or local models like Ollama.
- 🌐 **Web UI** – Streamlit-based interface for interactive investigations.
- 🐳 **Docker-Ready** – Recommended 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.
---
## ⚠️ Disclaimer
> 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.
## Installation
> [!NOTE]
> The tool needs Tor to do the searches. You can install Tor using `apt install tor` on Linux/Windows(WSL) or `brew install tor` on Mac. Once installed, confirm if Tor is running in the background.
> [!TIP]
> You can provide your LLM of choice API key by either creating .env file (refer to sample env file in the repo) or by setting env variables in PATH.
>
> For Ollama, provide `http://host.docker.internal:11434` as `OLLAMA_BASE_URL` in your env if running using docker method or `http://127.0.0.1:11434` for other methods. You might need to serve Ollama on 0.0.0.0 depending on your OS. You can do by running `OLLAMA_HOST=0.0.0.0 ollama serve &` in your terminal.
### Docker [Recommended]
- Pull the latest Robin docker image
```bash
docker pull apurvsg/robin:latest
```
- Run the docker image as:
```bash
docker run --rm \
-v "$(pwd)/.env:/app/.env" \
--add-host=host.docker.internal:host-gateway \
-p 8501:8501 \
apurvsg/robin:latest
```
- Open your browser and navigate to `http://localhost:8501`
### Using Python (Development Version)
- With `Python 3.10+` and Tor installed, run the following:
```bash
pip install -r requirements.txt
streamlit run ui.py
```
- Open your browser and navigate to `http://localhost:8501`
---
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request if you have major feature updates.
- 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
- If you have minor code changes
---
## Acknowledgements
- Idea inspiration from [Thomas Roccia](https://x.com/fr0gger_) and his demo of [Perplexity of the Dark Web](https://x.com/fr0gger_/status/1908051083068645558).
- Tools inspiration from my [OSINT Tools for the Dark Web](https://github.com/apurvsinghgautam/dark-web-osint-tools) repository.
- LLM Prompt inspiration from [OSINT-Assistant](https://github.com/AXRoux/OSINT-Assistant) repository.
- Logo Design by my friend [Tanishq Rupaal](https://github.com/Tanq16/)
- Workflow Design by [Chintan Gurjar](https://www.linkedin.com/in/chintangurjar)