How kevoreilly/capev2 works
CAPE is a malware sandbox. Analysts submit samples or URLs through the web API, MCP server, or CLI; tasks are scheduled onto isolated analysis machines, where guest agents and platform analyzers execute and instrument malware. Auxiliary collectors and processing plugins produce behavioral, network, memory, unpacked-payload, configuration, and signature results. Reports and artifacts are persisted for web review, optional central storage, similarity analysis, and interactive Guacamole sessions. Several subsystem links reflect README capabilities and tree structure; unsampled implementations are represented only at their exact enclosing paths.
Main entry points: analysis_manager.py Analysis Manager · reporting Report Writers · processing Processing Plugins · main.go Guest Agent
Components 24
Submission And Access
- Web Submission
web/submission/views.py - MCP Server
mcp/server.py - Analysis Views
web/analysis/views.py - Interactive Desktop
web/guac/consumers.py
Execution Orchestration
- Task Database
lib/cuckoo/core/database.py - Task Scheduler
lib/cuckoo/core/scheduler.py - Analysis Manager
lib/cuckoo/core/analysis_manager.py - Machine Manager
lib/cuckoo/core/machinery_manager.py - Network Routing
utils/router_manager.py
Guest Analysis
- Guest Agent
agent/go/main.go - Windows Analyzer
analyzer/windows/analyzer.py - Linux Analyzer
analyzer/linux/analyzer.py - Auxiliary Collectors
modules/auxiliary - Result Server
lib/cuckoo/core/resultserver.py
Analysis Processing
- Processing Engine
lib/cuckoo/core/processing_engine - Processing Plugins
modules/processing - Detection Signatures
modules/signatures - CAPE Extractors
modules/processing/CAPE.py
Results And Storage
- Artifact Storage
lib/cuckoo/common/artifact_storage.py - Object Storage
lib/cuckoo/common/storage_backend.py - Report Writers
modules/reporting - MCRIT Service
- Threat Intelligence
lib/cuckoo/common/integrations/threatintelligence
Other components
- Analyst
Connections 30
- Analyst → Web Submission: submits samples
- Analyst → MCP Server: submits tasks
- Analyst → Analysis Views: reviews reports
- Analyst → Interactive Desktop: opens desktop
- MCP Server → Web Submission: calls API
- Web Submission → Task Database: creates tasks
- Task Scheduler → Task Database: loads tasks
- Task Scheduler → Analysis Manager: dispatches tasks
- Analysis Manager → Machine Manager: starts machine
- Analysis Manager → Network Routing: configures routing
- Analysis Manager → Guest Agent: controls guest
- Machine Manager → Windows Analyzer: runs analyzer
- Machine Manager → Linux Analyzer: runs analyzer
- Windows Analyzer → Guest Agent: uses agent
- Linux Analyzer → Guest Agent: uses agent
- Analysis Manager → Auxiliary Collectors: runs auxiliaries
- Analysis Manager → Result Server: registers task
- Processing Engine → Processing Plugins: runs plugins
- Processing Engine → Detection Signatures: runs signatures
- Processing Engine → CAPE Extractors: extracts payloads
- Report Writers → Artifact Storage: stores artifacts
- Artifact Storage → Object Storage: uses backend
- Analysis Views → Report Writers: reads reports
- Processing Plugins → Report Writers: supplies results
- Detection Signatures → Report Writers: supplies detections
- CAPE Extractors → Report Writers: supplies configs
- Processing Plugins → MCRIT Service: queries similarity
- Processing Plugins → Threat Intelligence: queries intelligence
- Interactive Desktop → Analysis Manager: opens session
- Interactive Desktop → Guest Agent: tracks idle time