🤖 OpenOSINT
lang:en
OpenOSINT: The AI-Powered OSINT Agent
OpenOSINT is an open-source intelligence agent powered by artificial intelligence, featuring an interactive REPL interface, MCP server, and CLI. It supports 16 tools and works with Claude, GPT-4, or local models. Built exclusively for authorized security research.
Key Features
- 🚀 16 integrated OSINT tools — email, username, breach data, WHOIS, IP, subdomains, Google Dorks, Pastebin, phone, Shodan, VirusTotal, Censys, IP2Location, AbuseIPDB, GitHub, and DNS.
- 🤖 AI tool chaining — the agent autonomously decides which tool to use, chains investigations based on findings, and compiles structured reports.
- 💻 Triple interface — interactive terminal REPL, direct CLI for quick commands, and MCP server for native integration with Claude Code, Claude Desktop, or any MCP-compatible client.
- ⚡ Parallel execution — complementary tools run simultaneously via asyncio.gather() to accelerate investigations.
- 🎯 Multi-backend AI — Anthropic Claude via API, local Ollama (fully offline), or any OpenAI-compatible endpoint (LiteLLM, llama-swap, vLLM, LM Studio).
- 🧠 PDF + Markdown reports — auto-saved after every investigation, with PDF export via reportlab.
- 📦 Web UI — browser-based AI chat with streaming output, tool cards, and light/dark theme toggle.
- 🔧 Session history — all REPL sessions saved to ~/.openosint/history/, browsable with the history command.
Get Started
- 🐍
pip install openosint— install OpenOSINT from PyPI. - 💻
openosint— launch the interactive AI REPL. - 🌐
openosint web— launch the browser-based web UI. - 🔧
openosint email target@example.com— run a direct tool without AI.
Configuration
Copy .env.example to .env and add your API keys. Main variables include ANTHROPIC_API_KEY for Claude, OPENAI_BASE_URL for compatible backends, and optional keys for Shodan, VirusTotal, Censys, HaveIBeenPwned, and other integrations.
OpenOSINT Cloud
Hosted API for IP and domain intelligence: geolocation, proxy/VPN/Tor detection, abuse reputation, DNS records, and subdomain enumeration. No infrastructure to manage.
- 📊
curl -s -X POST https://api.openosint.tech/v1/enrich -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" -d '{"tool":"search_ip","target":"8.8.8.8"}'
👉 Project on GitHub: https://github.com/OpenOSINT/OpenOSINT