How noppakorn001/project-ctf_agent works
CTF Agent is a local-first orchestration console for authorized CTF challenges. The principal workflow imports a bounded challenge and artifacts, preprocesses and classifies them, applies scope and token policies, routes work through deterministic tools or an explicitly enabled model, records evidence, and verifies candidate flags before marking a challenge solved. The graph reflects the README’s documented architecture and capabilities; unsampled implementation details are represented only where the README explicitly documents them.
Main entry points: service.py CTFService · static Dashboard UI · http.py HTTP API · __main__.py CLI
Components 18
Operator experience
- Dashboard UI
ctf_agent/static - HTTP API
ctf_agent/http.py - CLI
ctf_agent/__main__.py
Challenge orchestration
- CTFService
ctf_agent/service.py - Deterministic core
ctf_agent/core.py
Solving capabilities
- Model providers
ctf_agent/providers.py - Offline recipes
ctf_agent/recipes.py - Deterministic solvers
ctf_agent/deterministic_solvers.py - Category playbooks
ctf_agent/playbooks.py - Web solvers
ctf_agent/web_solvers.py - CryptoHack archive
ctf_agent/cryptohack_archive.py - Approved sandbox
ctf_agent/sandbox.py - Knowledge base
knowledge
State and evidence
- SQLite state
ctf_agent/storage.py
Other components
- Operator
- Browser
- External model
- Codex workflow
Connections 18
- Operator → Browser: uses
- Browser → Dashboard UI: opens
- Dashboard UI → HTTP API: JSON requests
- Operator → CLI: runs
- CLI → CTFService: starts and invokes
- HTTP API → CTFService: dispatches requests
- CTFService → Deterministic core: triages and verifies
- CTFService → Model providers: requests model work
- CTFService → SQLite state: reads and writes
- Model providers → External model: calls when enabled
- CTFService → Offline recipes: uses offline transforms
- CTFService → Deterministic solvers: runs evidenced routes
- CTFService → Category playbooks: discovers guidance
- CTFService → Web solvers: routes web work
- CTFService → CryptoHack archive: runs archive commands
- CTFService → Approved sandbox: requests approved inspection
- Codex workflow → Category playbooks: uses
- Codex workflow → Knowledge base: consults