How buseclab/cve-genie works
CVE-Genie extracts or accepts vulnerability context, then coordinates repository preparation, exploit development, and verification to produce a reproduction run. Its agent library supplies planning, model access, parsing, persistence, tool execution, and a conversation console; VM utilities provide an alternate execution environment, while the visualizer inspects completed runs. The README documents these product stages and capabilities. Some subsystem connections are documented only at a high level; unsampled implementation details are not inferred.
Main entry points: agent.py Agent execution · main.py Run orchestrator · repoBuilder.py Repository builder · run_cve.py VM execution
Components 34
CVE reproduction
- CVE extraction
src/data/scripts/cve_data.py - Context processing
src/toolbox/cve_data_processor.py - Run orchestrator
src/main.py
Agent workflows
- Repository builder
src/agents/repoBuilder.py - Repository critic
src/agents/repoCritic.py - Prerequisite builder
src/agents/preReqBuilder.py - Knowledge builder
src/agents/knowledgeBuilder.py - Exploit agent
src/agents/exploiter.py - Exploit critic
src/agents/exploitCritic.py - CTF verifier
src/agents/ctfVerifier.py - Sanity checks
src/agents/sanityGuy.py
Agent runtime
- Agent execution
src/agentlib/agentlib/lib/agents/agent.py - Plan execution
src/agentlib/agentlib/lib/agents/planning.py - Agent review
src/agentlib/agentlib/lib/agents/critic.py - Model access
src/agentlib/agentlib/lib/common/llm_api.py - Model registry
src/agentlib/agentlib/lib/common/available_llms.py - Output parsing
src/agentlib/agentlib/lib/common/parsers.py - Persistent objects
src/agentlib/agentlib/lib/common/object.py - Runtime callbacks
src/agentlib/agentlib/lib/common/base.py - Code handling
src/agentlib/agentlib/lib/common/code.py - Agent tools
src/agentlib/agentlib/lib/tools/tool_wrapper.py - Agent console
src/agentlib/agentlib/lib/web_console.py - LLM records
src/agentlib/agentlib/lib/common/store.py
Execution and inspection
- Shell operations
src/toolbox/command_ops.py - Tool collection
src/toolbox/tools.py - VM execution
vm_library/run_cve.py - Snapshot runs
vm_library/run_cve_with_snaps.py - QEMU utilities
vm_library/qemu_utils.py - SSH utilities
vm_library/ssh_utils.py - Run visualizer
visualizer/serve.py - Log parsing
visualizer/log-parser.js - Run data loader
visualizer/data-loader.js - Visualizer UI
visualizer/ui.js
Other components
- Engineer
Connections 38
- Engineer → CVE extraction: extracts context
README.md - Engineer → Run orchestrator: starts reproduction
README.md - CVE extraction → Context processing: prepares context
- Run orchestrator → Context processing: processes context
src/main.py - Run orchestrator → Repository builder: invokes build
src/main.py - Run orchestrator → Exploit agent: invokes exploit
src/main.py - Run orchestrator → CTF verifier: invokes verify
src/main.py - Run orchestrator → Repository critic: reviews repository
- Run orchestrator → Exploit critic: reviews exploit
src/main.py - Run orchestrator → Prerequisite builder: builds prerequisites
- Run orchestrator → Knowledge builder: builds knowledge
- Run orchestrator → Sanity checks: checks run
- Repository builder → Agent execution: uses agent framework
- Exploit agent → Agent execution: uses agent framework
src/agents/exploiter.py - Exploit critic → Agent execution: uses agent framework
src/agents/exploitCritic.py - Sanity checks → Agent execution: uses agent framework
src/agents/sanityGuy.py - Agent execution → Model access: calls model API
src/agentlib/agentlib/lib/agents/agent.py - Agent execution → Model registry: selects model
src/agentlib/agentlib/lib/agents/agent.py - Agent execution → Output parsing: parses responses
src/agentlib/agentlib/lib/agents/agent.py - Agent execution → Agent tools: dispatches tools
src/agentlib/agentlib/lib/agents/agent.py - Agent execution → Persistent objects: persists objects
src/agentlib/agentlib/lib/agents/agent.py - Agent execution → Runtime callbacks: uses callbacks
src/agentlib/agentlib/lib/agents/agent.py - Plan execution → Agent execution: extends execution
src/agentlib/agentlib/lib/agents/planning.py - Plan execution → Agent review: requests review
src/agentlib/agentlib/lib/agents/planning.py - Output parsing → Code handling: extracts code
src/agentlib/agentlib/lib/common/parsers.py - Repository builder → Tool collection: uses tools
- Tool collection → Shell operations: includes commands
src/toolbox/tools.py - Engineer → VM execution: runs in VM
README.md - VM execution → QEMU utilities: manages VM
vm_library/run_cve.py - VM execution → SSH utilities: connects by SSH
vm_library/run_cve.py - Snapshot runs → QEMU utilities: manages snapshots
vm_library/run_cve_with_snaps.py - Snapshot runs → SSH utilities: connects by SSH
vm_library/run_cve_with_snaps.py - Engineer → Run visualizer: opens visualizer
README.md - Run visualizer → Visualizer UI: serves interface
README.md - Visualizer UI → Run data loader: loads run
visualizer/ui.js - Run data loader → Log parsing: parses logs
visualizer/data-loader.js - Agent execution → Agent console: records activity
src/agentlib/agentlib/lib/agents/agent.py - Agent console → LLM records: stores records
src/agentlib/agentlib/lib/web_console.py