🤖 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