How krockodog/cyber-pentest-swarm-ai works
Cyber Pentest Swarm AI is an AI-assisted penetration-testing platform with CLI and web interfaces, a Go API, specialist agents, security tools, and report generation. Its principal documented scan workflow runs reconnaissance, vulnerability classification, exploitation, and reporting, with agents sharing findings through a PostgreSQL-backed blackboard. The README also documents bug-bounty scanning, OSINT, voice/TTS, and integrations. Several links below are documented by the README or source index; unsampled implementation details are not inferred.
Main entry points: engine.py Bug-bounty workflow · coordinator.go Swarm coordinator · server.go REST API · runner.go Scan engine
Components 28
User interfaces
- CLI
cli/root.go - Web dashboard
web/src/app/page.tsx
API and orchestration
- REST API
internal/api/server.go - Scan engine
internal/engine/runner.go - Swarm coordinator
internal/swarm/coordinator.go - Finding blackboard
internal/swarm/blackboard/board.go - Python agent framework
swarm-agents/bb/src/agent_base.py
Assessment workflow
- Scope controls
internal/scope/validator.go - Recon agents
swarm-agents/recon/src/main.py - Finding classifier
internal/agent/classifier/agent.go - Exploit agents
swarm-agents/exploit/src/main.py - Bug-bounty workflow
swarm-agents/bughunter/engine.py - Security tools
internal/tools/coordinator.go - Bug-bounty scope
swarm-agents/bughunter/scope.py - Bug-bounty recon
swarm-agents/bughunter/recon.py - Bug-bounty OSINT
swarm-agents/bughunter/osint.py - Finding ranker
swarm-agents/bughunter/ranker.py - Target probe
swarm-agents/bughunter/probe.py - Bug-bounty agent
swarm-agents/bughunter/agent.py - Skill map
swarm-agents/bughunter/skill_map.py
Findings and reporting
- Report generation
internal/agent/report/agent.go - Report renderers
internal/agent/report/renderer.go - Campaign storage
internal/db/postgres.go - Engagement state
swarm-agents/bughunter/state.py
Platform capabilities
- LLM providers
internal/llm/provider.go - Voice and TTS
internal/voice/service.go - External integrations
internal/integrations
Other components
- Analyst
Connections 32
- Analyst → CLI: runs scans
- Analyst → Web dashboard: uses dashboard
- CLI → Scan engine: starts scans
- Web dashboard → REST API: REST requests
- CLI → REST API: starts server
- REST API → Scan engine: invokes
internal/api/server.go - Scan engine → Swarm coordinator: runs swarm
- Swarm coordinator → Finding blackboard: shares findings
- Scan engine → Scope controls: checks scope
- Swarm coordinator → Recon agents: dispatches
- Swarm coordinator → Finding classifier: dispatches
- Swarm coordinator → Exploit agents: dispatches
- Swarm coordinator → Report generation: dispatches
- Recon agents → Finding classifier: findings flow
- Finding classifier → Exploit agents: findings flow
- Exploit agents → Report generation: results flow
- Swarm coordinator → Security tools: uses tools
- Report generation → Report renderers: renders reports
- REST API → Campaign storage: reads campaigns
internal/api/server.go - REST API → Report generation: reads findings
internal/api/server.go - Swarm coordinator → LLM providers: uses models
- REST API → Voice and TTS: serves voice routes
internal/api/server.go - REST API → External integrations: uses integrations
internal/api/server.go - Python agent framework → Bug-bounty agent: framework for
- Bug-bounty workflow → Bug-bounty scope: imports scope
swarm-agents/bughunter/engine.py - Bug-bounty workflow → Bug-bounty recon: imports recon
swarm-agents/bughunter/engine.py - Bug-bounty workflow → Bug-bounty OSINT: imports OSINT
swarm-agents/bughunter/engine.py - Bug-bounty workflow → Finding ranker: imports ranker
swarm-agents/bughunter/engine.py - Bug-bounty workflow → Target probe: imports probe
swarm-agents/bughunter/engine.py - Bug-bounty workflow → Engagement state: imports state
swarm-agents/bughunter/engine.py - Bug-bounty workflow → Bug-bounty agent: imports agent
swarm-agents/bughunter/engine.py - Bug-bounty workflow → Skill map: imports skills
swarm-agents/bughunter/engine.py