pikpikcu/airecon
AIRecon is an autonomous cybersecurity agent that combines a self-hosted Large Language Model (Ollama) with a Kali Linux Docker sandbox and a Textual TUI. It is designed to automate security assessments, penetration testing, and bug bounty reconnaissance — without any API keys or cloud dependency.
What it solves
AIRecon is an autonomous penetration testing agent designed to automate the complex process of security reconnaissance and exploitation. It removes the need for manual tool chaining by using an LLM to drive a security-focused sandbox, allowing users to conduct full-stack security audits from discovery to reporting.
How it works
The agent operates through a structured pipeline (RECON $\rightarrow$ ANALYSIS $\rightarrow$ EXPLOIT $\rightarrow$ REPORT) and integrates with an OpenAI-compatible LLM gateway. It executes commands within a Kali Linux Docker sandbox and integrates natively with the Caido proxy.
To enhance its decision-making, it uses a local SQLite memory database to track findings and patterns, and can optionally connect to a massive local knowledge base (airecon-dataset) containing over 1 million security records (CVEs, CTF writeups, etc.) via a dataset_search tool. It also supports the Model Context Protocol (MCP) to extend its toolset with external servers.
Who it’s for
Security researchers, penetration testers, and bug bounty hunters who want to automate repetitive reconnaissance tasks and complex attack chains while maintaining the option for fully offline, private operation using local models.
Highlights
- Backend Agnostic: Works with any OpenAI-compatible gateway, supporting both hosted models and local ones (e.g., via vLLM or Ollama).
- Kali Sandbox: Executes tools in a secure, isolated Docker environment.
- Native Caido Integration: Built-in support for proxy tools like replay, fuzzing, and sitemap management.
- ** uma Local Knowledge Base**: Optional indexing of ~1.09M security records for grounded, autonomous decision-making.
- Verified-only Learning: Persists only high-confidence findings to its cross-session brain to avoid noise.
- Automatic Reasoning Detection: Detects at runtime whether a model supports reasoning capabilities without needing hardcoded lists.
Related
- Project
- Project
- Project
- Project
- Project