How outstandingom/ctf-agent-orchestrator works
The repository is a CTF AI orchestration command center: users submit a challenge through the dashboard/API, then the orchestrator routes work to specialist tools and returns findings or a solution. Its broader documented capabilities include crypto and symbolic solving, forensics, browser/web analysis, knowledge retrieval, competition monitoring, and software patching. The Apex Gauntlet and Quantum Vault are companion challenge applications with solvers. Some integrations and agent subsystems are documented but not fully sampled, so those links rely on README evidence.
Main entry points: agent.py Tool Router · server.py Dashboard API · solve_full_chain.py Apex Chain Solver · solve_playwright_interactive.py Apex Browser Solver
Components 25
Command Center
- Dashboard API
server.py - Challenge Upload
server.py
Agent Orchestration
- CTF Agent
agent.py - Tool Router
agent.py - LLM Reasoning
agent.py - SWE Patch Tools
agent.py
Challenge Analysis
- Crypto Solvers
agent.py - SMT Solver
agent.py - Web Fuzzing
agent.py - Browser Automation
agent.py - Forensics Engine
agent.py - Python Sandbox
agent.py - Binary Analysis
agent.py
Knowledge And Integrations
- Vector RAG
agent.py - Knowledge Graph
- CTFd Monitor
agent.py - MCP Gateway
agent.py - Solve Ledger
agent.py
Challenge Labs
- Apex Gauntlet
challenges/apex_gauntlet/app.py - Apex Chain Solver
challenges/apex_gauntlet/solvers/solve_full_chain.py - Apex Browser Solver
challenges/apex_gauntlet/solvers/solve_playwright_interactive.py - Quantum Vault
challenges/quantum_vault/app.py - Vault Exploit Solver
challenges/quantum_vault/solvers/solve_ssti.py - Vault Z3 Solver
challenges/quantum_vault/solvers/solve_z3_passcode.py
Other components
- CTF Operator
Connections 26
- CTF Operator → Dashboard API: submits challenge
README.md - Dashboard API → Challenge Upload: accepts files
server.py - Dashboard API → CTF Agent: invokes tools
server.py - Challenge Upload → CTF Agent: provides challenge
server.py - CTF Agent → Tool Router: routes requests
README.md - CTF Agent → LLM Reasoning: reasons over task
README.md - Tool Router → Crypto Solvers: dispatches attacks
README.md - Tool Router → SMT Solver: dispatches constraints
README.md - Tool Router → Web Fuzzing: dispatches probes
README.md - Tool Router → Browser Automation: dispatches browser work
README.md - Tool Router → Forensics Engine: dispatches inspection
README.md - Tool Router → Python Sandbox: executes code
README.md - Tool Router → Binary Analysis: dispatches analysis
agent.py - Tool Router → Vector RAG: searches knowledge
agent.py - Vector RAG → Knowledge Graph: retrieves campaign state
- Tool Router → CTFd Monitor: monitors competitions
README.md - Tool Router → MCP Gateway: requests remote operations
agent.py - CTF Agent → Solve Ledger: records solves
agent.py - Tool Router → SWE Patch Tools: dispatches patches
agent.py - Apex Chain Solver → Apex Gauntlet: requests stage APIs
challenges/apex_gauntlet/solvers/solve_full_chain.py - Apex Chain Solver → CTF Agent: invokes solving tools
challenges/apex_gauntlet/solvers/solve_full_chain.py - Apex Browser Solver → Apex Gauntlet: drives challenge UI
challenges/apex_gauntlet/solvers/solve_playwright_interactive.py - Apex Browser Solver → CTF Agent: invokes solving tools
challenges/apex_gauntlet/solvers/solve_playwright_interactive.py - Vault Exploit Solver → Vault Z3 Solver: solves passcode
challenges/quantum_vault/solvers/solve_ssti.py - Vault Exploit Solver → Quantum Vault: submits exploit requests
challenges/quantum_vault/solvers/solve_ssti.py - Vault Z3 Solver → Quantum Vault: derives unlock code