"He doesn’t guard the gates of hell—he scans the ports of your infrastructure."

Hades is a modular, AI-powered cybersecurity agent that combines an interactive CLI, a FastAPI backend, and a web-based AI Developer Kit (ADK) to assist red teamers, bug bounty hunters, and security engineers with context-aware pentesting, reconnaissance, vulnerability assessment, and AI-driven exploit workflows.

• Interactive terminal with a Metasploit-style prompt.
• FastAPI client with context-aware AI prompt generation.
• Graceful error handling, modular command manager, and conversation context management.

• Handles AI generation requests.
• Integrates with LLMs (OpenAI, Ollama, Claude, etc.).
• Manages prompt context and response shaping.

• Web dashboard for controlling and visualizing agent behavior.
• Real-time interaction with the AI engine.
• Useful for debugging, demos, or teaching pentest concepts interactively.

Hades/
├── cli/                     # Go-based CLI tool
│   └── cmd/hades/main.go
├── server/                  # FastAPI backend
│   ├── main.py
│   └── api/
│       └── routes.py
├── web/                     # (Optional) Web ADK frontend
│   └── (NextJs)
├── shared/                  # Shared configs, enums, models
├── .env                     # Environment configs
└── README.md                # You are here

• Go 1.21+ (for CLI)
• Python 3.10+ (for FastAPI server)
• Docker (optional, for isolated environments)

git clone https://github.com/NexorTech/hades.git
cd hades

cd cli
go mod tidy
go build -o hades cmd/hades/main.go

cd server
pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --port 8080

• Method: POST
• Request:

{
  "prompt": "Find vulnerabilities in this service.",
  "context": "Previously scanned open ports: 22, 80, 443"
}

• Response:

{
  "text": "Based on the ports found, attempt a brute-force SSH scan on port 22...",
  "context": "Updated internal context"
}

Edit .env file or export these variables:

You can run all services together using Docker Compose (coming soon). Preview setup:

docker-compose up --build

• CLI with AI generator
• FastAPI backend server
• Web ADK integration
• Nmap, Subfinder, Nuclei module bridges
• Offline LLM inference via Ollama
• Post-exploitation AI suggestion engine

Hades is more than a tool — it’s a framework for human-AI synergy in ethical hacking. You type, it reasons. You aim, it executes. You guide, it adapts.

MIT License. See LICENSE file for details.

Pull requests are welcome! Please:

1. Fork the repo
2. Create a branch (git checkout -b feat/your-feature)
3. Commit and push
4. Submit a PR

• GitHub: @MohakGupta2004
• Email: mohakgupta500@gmail.com