How trannhatbuilder/autonomous-vapt-system works
VAPT-AI is a vulnerability-assessment and penetration-testing platform. Its principal workflow is a user-initiated scan: the API starts a pipeline, consent and scan state are managed, an orchestrator delegates work to agents and tools, and findings are persisted and reported with progress events. Separate capabilities include authentication, human-in-the-loop review, evidence handling, C2/exploit support, and a web interface. The README is empty; relationships below rely on the supplied source excerpts and SOURCE INDEX, so unsampled subsystem links are omitted where unverified.
Main entry points: scan_pipeline.py Scan Pipeline · session.py PostgreSQL Store · langgraph_supervisor.py Supervisor Orchestrator · main.py FastAPI Application
Components 23
Interface and API
- Web Console
frontend/src/app/page.tsx - FastAPI Application
app/main.py - Orchestration Routes
app/routes/orchestration.py - Authentication
app/auth/manager.py
Scan Execution
- Scan Pipeline
app/pentest/scan_pipeline.py - Supervisor Orchestrator
app/orchestration/langgraph_supervisor.py - Scan Events
app/pentest/events.py - Active Scan Registry
app/pentest/scan_registry.py
Agents and Tools
- Agent Registry
app/agents/registry.py - Agent Runtime
app/agents/base.py - Agent LLM Shim
app/agents/llm_client.py - Tool Execution
app/mcp/execution_service.py
Safety and Evidence
- Consent and Scope
app/consent/manager.py - HITL Review
app/hitl/manager.py - Validation Harness
app/harness - Evidence Service
app/evidence/service.py - Report Export
app/report
State and Integrations
- LLM Client
app/core/llm_client.py - PostgreSQL Store
app/db/session.py - C2 Management
app/c2/manager.py - Exploit Sessions
app/exploit/session_manager.py
Other components
- Operator
- LLM Provider
Connections 24
- Operator → Web Console: operates
frontend/src/app/page.tsx - Web Console → FastAPI Application: requests
- FastAPI Application → Orchestration Routes: routes requests
app/main.py - Orchestration Routes → Scan Pipeline: starts scans
app/routes/orchestration.py - FastAPI Application → Authentication: authenticates
app/main.py - Scan Pipeline → Consent and Scope: checks consent
- Scan Pipeline → Supervisor Orchestrator: runs orchestration
app/pentest/scan_pipeline.py - Orchestration Routes → Supervisor Orchestrator: selects mode
app/routes/orchestration.py - Supervisor Orchestrator → Agent Registry: looks up agents
app/orchestration/langgraph_supervisor.py - Supervisor Orchestrator → Agent Runtime: delegates tasks
app/orchestration/langgraph_supervisor.py - Agent Runtime → Agent LLM Shim: requests completions
app/agents/base.py - Agent LLM Shim → LLM Client: delegates calls
app/agents/llm_client.py - LLM Client → LLM Provider: sends requests
- Agent Runtime → Tool Execution: executes tools
app/agents/base.py - Scan Pipeline → Active Scan Registry: checks abort state
app/pentest/scan_pipeline.py - Scan Pipeline → Scan Events: emits progress
app/pentest/scan_pipeline.py - Scan Pipeline → Evidence Service: persists findings
app/pentest/scan_pipeline.py - Scan Pipeline → Report Export: generates reports
app/pentest/scan_pipeline.py - Scan Pipeline → PostgreSQL Store: persists scan data
app/pentest/scan_pipeline.py - HITL Review → Active Scan Registry: checks aborts
app/hitl/manager.py - Scan Events → PostgreSQL Store: persists event history
app/pentest/events.py - Evidence Service → PostgreSQL Store: stores evidence
app/evidence/service.py - C2 Management → PostgreSQL Store: stores C2 state
app/c2/manager.py - Exploit Sessions → PostgreSQL Store: stores sessions
app/exploit/session_manager.py