How igen-uk07/velric works
Velric is a static PE/ELF security analyzer. Its user workflow is to submit a binary through the CLI, parse its format and collect structural, capability, behavioral, YARA, and disassembly evidence, then normalize and correlate findings, score risk, enrich with ATT&CK metadata, and render a terminal or JSON report. The graph preserves the documented analysis branches and major analyzer modules. Some subsystem links come from README or SOURCE INDEX references; unsampled implementation details are not inferred beyond those references.
Main entry points: analysis_engine.py Analysis Engine · cli.py CLI · disassembler.py Disassembly · enricher.py ATT&CK Enrichment
Components 22
User Interface
- CLI
velric/cli.py - Analysis Engine
velric/core/analysis_engine.py
Binary Analysis
- PE Parser
velric/parsers/pe_parser.py - ELF Parser
velric/parsers/elf_parser.py - Import Normalizer
velric/core/import_normalizer.py - Disassembly
velric/disassembly/disassembler.py - Instruction Analysis
velric/disassembly/instruction_analyzer.py
Security Findings
- Capability Analysis
velric/analyzers/capability_analyzer.py - Network Analysis
velric/analyzers/network_analyzer.py - String Analysis
velric/analyzers/string_analyzer.py - Entropy Analysis
velric/analyzers/entropy_analyzer.py - Packing Analysis
velric/analyzers/packing_analyzer.py - Instruction Security
velric/analyzers/instruction_security_analyzer.py - YARA Scanning
velric/yara/analyzer.py
Finding Assessment
- Finding Normalizer
velric/risk/normalizer.py - Behavior Correlator
velric/risk/correlator.py - Risk Scoring
velric/risk/risk_engine.py - ATT&CK Enrichment
velric/mitre/enricher.py
Results
- Analysis Result
velric/core/analysis_result.py - Terminal Report
velric/output/terminal_reporter.py - JSON Report
velric/output/json_reporter.py
Other components
- Analyst
Connections 22
- Analyst → CLI: submits binary
README.md - CLI → Analysis Engine: runs analysis
velric/cli.py - Analysis Engine → PE Parser: parses PE
velric/core/analysis_engine.py - Analysis Engine → ELF Parser: parses ELF
velric/core/analysis_engine.py - Analysis Engine → Import Normalizer: normalizes imports
README.md - Analysis Engine → Disassembly: collects disassembly
velric/core/analysis_engine.py - Disassembly → Instruction Analysis: analyzes instructions
velric/core/collectors/disassembly_collector.py - Analysis Engine → Capability Analysis: collects security
- Analysis Engine → Network Analysis: collects security
- Analysis Engine → String Analysis: extracts strings
velric/core/analysis_engine.py - Analysis Engine → Entropy Analysis: collects security
- Analysis Engine → Packing Analysis: collects security
- Analysis Engine → Instruction Security: collects security
- Analysis Engine → YARA Scanning: scans binary
velric/core/analysis_engine.py - Analysis Engine → Finding Normalizer: normalizes findings
velric/core/analysis_engine.py - Analysis Engine → Behavior Correlator: correlates findings
velric/core/analysis_engine.py - Analysis Engine → Risk Scoring: scores findings
velric/core/analysis_engine.py - Analysis Engine → ATT&CK Enrichment: enriches findings
velric/core/analysis_engine.py - ATT&CK Enrichment → Analysis Result: adds mappings
- CLI → Terminal Report: prints report
velric/cli.py - CLI → JSON Report: writes report
velric/cli.py - Analysis Engine → Analysis Result: builds result
velric/core/analysis_engine.py