# mandiant/capa architecture

> Architecture diagram of the GitHub repository mandiant/capa, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mandiant/capa
- Repository: https://github.com/mandiant/capa

## Overview

capa is a malware-capability analyzer: the CLI accepts executable samples or sandbox reports, selects an extractor, evaluates extracted features against rules, and presents capability results. Static analysis has multiple backend integrations; dynamic analysis consumes reports. Results can also be frozen or explored interactively in the browser, and IDA/Ghidra plugins provide analyst-facing integrations. Some subsystem links are documented only at a high level; the graph avoids asserting unshown calls.

Main entry points: [`capa/main.py`](https://github.com/mandiant/capa/blob/master/capa/main.py) (CLI orchestration), [`capa/features/extractors`](https://github.com/mandiant/capa/tree/master/capa/features/extractors) (Static extractors), [`capa/features/extractors/base_extractor.py`](https://github.com/mandiant/capa/blob/master/capa/features/extractors/base_extractor.py) (Extractor interface), [`capa/loader.py`](https://github.com/mandiant/capa/blob/master/capa/loader.py) (Input loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Analysis entry"]
  node_cli["CLI orchestration<br/>[main.py]"]
  node_loader["Input loader<br/>[loader.py]"]
end

subgraph group_extract["Feature extraction"]
  node_static["Static extractors"]
  node_dynamic["Sandbox extractors"]
  node_extractor_api["Extractor interface<br/>[base_extractor.py]"]
  node_elf["ELF analysis<br/>[elf.py]"]
  node_ghidra["Ghidra backend<br/>[extractor.py]"]
  node_feature_model["Feature model<br/>[common.py]"]
  node_feature_address["Feature addresses<br/>[address.py]"]
end

subgraph group_matching["Capability matching"]
  node_rules["Rule loading<br/>[__init__.py]"]
  node_engine["Rule evaluator<br/>[engine.py]"]
  node_capabilities["Capability analysis<br/>[common.py]"]
  node_static_caps["Static matching<br/>[static.py]"]
  node_dynamic_caps["Dynamic matching<br/>[dynamic.py]"]
end

subgraph group_results["Results and export"]
  node_result_doc["Result document<br/>[result_document.py]"]
  node_renderers["CLI renderers"]
  node_freeze["Feature freezing"]
end

subgraph group_integrations["Analyst interfaces"]
  node_explorer["Browser Explorer<br/>[App.vue]"]
  node_explorer_loader["Result loading<br/>[useRdocLoader.js]"]
  node_explorer_parser["Result parser<br/>[rdocParser.js]"]
  node_ida_plugin["IDA plugin<br/>[form.py]"]
  node_ghidra_plugin["Ghidra plugin<br/>[capa_explorer.py]"]
end

node_analyst(("Analyst"))
node_sample["Sample or report"]

node_analyst -->|"runs analysis"| node_cli
node_sample -->|"provides input"| node_cli
node_cli -->|"loads sample"| node_loader
node_loader -->|"selects backend"| node_static
node_loader -->|"selects backend"| node_dynamic
node_static -.->|"implements interface"| node_extractor_api
node_dynamic -.->|"implements interface"| node_extractor_api
node_static -.->|"includes backend"| node_elf
node_static -.->|"includes backend"| node_ghidra
node_ghidra -->|"uses interface"| node_extractor_api
node_extractor_api -->|"yields features"| node_feature_model
node_feature_model -->|"uses addresses"| node_feature_address
node_cli -->|"loads rules"| node_rules
node_cli -->|"analyzes features"| node_capabilities
node_capabilities -->|"dispatches static"| node_static_caps
node_capabilities -->|"dispatches dynamic"| node_dynamic_caps
node_static_caps -->|"evaluates rules"| node_engine
node_dynamic_caps -->|"evaluates rules"| node_engine
node_static_caps -->|"records matches"| node_result_doc
node_dynamic_caps -->|"records matches"| node_result_doc
node_cli -->|"renders results"| node_renderers
node_renderers -->|"formats document"| node_result_doc
node_cli -->|"can freeze features"| node_freeze
node_analyst -->|"explores results"| node_explorer
node_explorer -.->|"loads documents"| node_explorer_loader
node_explorer_loader -.->|"parses results"| node_explorer_parser
node_analyst -.->|"uses analysis plugin"| node_ida_plugin
node_analyst -.->|"uses analysis plugin"| node_ghidra_plugin

click node_cli "https://github.com/mandiant/capa/blob/master/capa/main.py"
click node_loader "https://github.com/mandiant/capa/blob/master/capa/loader.py"
click node_static "https://github.com/mandiant/capa/tree/master/capa/features/extractors"
click node_dynamic "https://github.com/mandiant/capa/tree/master/capa/features/extractors"
click node_extractor_api "https://github.com/mandiant/capa/blob/master/capa/features/extractors/base_extractor.py"
click node_elf "https://github.com/mandiant/capa/blob/master/capa/features/extractors/elf.py"
click node_ghidra "https://github.com/mandiant/capa/blob/master/capa/features/extractors/ghidra/extractor.py"
click node_feature_model "https://github.com/mandiant/capa/blob/master/capa/features/common.py"
click node_feature_address "https://github.com/mandiant/capa/blob/master/capa/features/address.py"
click node_rules "https://github.com/mandiant/capa/blob/master/capa/rules/__init__.py"
click node_engine "https://github.com/mandiant/capa/blob/master/capa/engine.py"
click node_capabilities "https://github.com/mandiant/capa/blob/master/capa/capabilities/common.py"
click node_static_caps "https://github.com/mandiant/capa/blob/master/capa/capabilities/static.py"
click node_dynamic_caps "https://github.com/mandiant/capa/blob/master/capa/capabilities/dynamic.py"
click node_result_doc "https://github.com/mandiant/capa/blob/master/capa/render/result_document.py"
click node_renderers "https://github.com/mandiant/capa/tree/master/capa/render"
click node_freeze "https://github.com/mandiant/capa/tree/master/capa/features/freeze"
click node_explorer "https://github.com/mandiant/capa/blob/master/web/explorer/src/App.vue"
click node_explorer_loader "https://github.com/mandiant/capa/blob/master/web/explorer/src/composables/useRdocLoader.js"
click node_explorer_parser "https://github.com/mandiant/capa/blob/master/web/explorer/src/utils/rdocParser.js"
click node_ida_plugin "https://github.com/mandiant/capa/blob/master/capa/ida/plugin/form.py"
click node_ghidra_plugin "https://github.com/mandiant/capa/blob/master/capa/ghidra/plugin/capa_explorer.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_loader toneBlue
class node_static,node_dynamic,node_extractor_api,node_elf,node_ghidra,node_feature_model,node_feature_address toneAmber
class node_rules,node_engine,node_capabilities,node_static_caps,node_dynamic_caps toneMint
class node_result_doc,node_renderers,node_freeze toneRose
class node_explorer,node_explorer_loader,node_explorer_parser,node_ida_plugin,node_ghidra_plugin,node_analyst,node_sample toneIndigo
```

## Components

### Analysis entry

- [CLI orchestration](https://github.com/mandiant/capa/blob/master/capa/main.py): `capa/main.py`
- [Input loader](https://github.com/mandiant/capa/blob/master/capa/loader.py): `capa/loader.py`

### Feature extraction

- [Static extractors](https://github.com/mandiant/capa/tree/master/capa/features/extractors): `capa/features/extractors`
- [Sandbox extractors](https://github.com/mandiant/capa/tree/master/capa/features/extractors): `capa/features/extractors`
- [Extractor interface](https://github.com/mandiant/capa/blob/master/capa/features/extractors/base_extractor.py): `capa/features/extractors/base_extractor.py`
- [ELF analysis](https://github.com/mandiant/capa/blob/master/capa/features/extractors/elf.py): `capa/features/extractors/elf.py`
- [Ghidra backend](https://github.com/mandiant/capa/blob/master/capa/features/extractors/ghidra/extractor.py): `capa/features/extractors/ghidra/extractor.py`
- [Feature model](https://github.com/mandiant/capa/blob/master/capa/features/common.py): `capa/features/common.py`
- [Feature addresses](https://github.com/mandiant/capa/blob/master/capa/features/address.py): `capa/features/address.py`

### Capability matching

- [Rule loading](https://github.com/mandiant/capa/blob/master/capa/rules/__init__.py): `capa/rules/__init__.py`
- [Rule evaluator](https://github.com/mandiant/capa/blob/master/capa/engine.py): `capa/engine.py`
- [Capability analysis](https://github.com/mandiant/capa/blob/master/capa/capabilities/common.py): `capa/capabilities/common.py`
- [Static matching](https://github.com/mandiant/capa/blob/master/capa/capabilities/static.py): `capa/capabilities/static.py`
- [Dynamic matching](https://github.com/mandiant/capa/blob/master/capa/capabilities/dynamic.py): `capa/capabilities/dynamic.py`

### Results and export

- [Result document](https://github.com/mandiant/capa/blob/master/capa/render/result_document.py): `capa/render/result_document.py`
- [CLI renderers](https://github.com/mandiant/capa/tree/master/capa/render): `capa/render`
- [Feature freezing](https://github.com/mandiant/capa/tree/master/capa/features/freeze): `capa/features/freeze`

### Analyst interfaces

- [Browser Explorer](https://github.com/mandiant/capa/blob/master/web/explorer/src/App.vue): `web/explorer/src/App.vue`
- [Result loading](https://github.com/mandiant/capa/blob/master/web/explorer/src/composables/useRdocLoader.js): `web/explorer/src/composables/useRdocLoader.js`
- [Result parser](https://github.com/mandiant/capa/blob/master/web/explorer/src/utils/rdocParser.js): `web/explorer/src/utils/rdocParser.js`
- [IDA plugin](https://github.com/mandiant/capa/blob/master/capa/ida/plugin/form.py): `capa/ida/plugin/form.py`
- [Ghidra plugin](https://github.com/mandiant/capa/blob/master/capa/ghidra/plugin/capa_explorer.py): `capa/ghidra/plugin/capa_explorer.py`

### Other components

- **Analyst**
- **Sample or report**

## Connections

- Analyst → CLI orchestration: runs analysis
- Sample or report → CLI orchestration: provides input
- CLI orchestration → Input loader: loads sample (evidence: `capa/main.py`)
- Input loader → Static extractors: selects backend (evidence: `capa/loader.py`)
- Input loader → Sandbox extractors: selects backend (evidence: `capa/loader.py`)
- Static extractors → Extractor interface: implements interface (evidence: `capa/features/extractors/ghidra/extractor.py`)
- Sandbox extractors → Extractor interface: implements interface (evidence: `capa/features/extractors/ghidra/extractor.py`)
- Static extractors → ELF analysis: includes backend
- Static extractors → Ghidra backend: includes backend (evidence: `capa/features/extractors/ghidra/extractor.py`)
- Ghidra backend → Extractor interface: uses interface (evidence: `capa/features/extractors/ghidra/extractor.py`)
- Extractor interface → Feature model: yields features (evidence: `capa/features/extractors/base_extractor.py`)
- Feature model → Feature addresses: uses addresses (evidence: `capa/features/common.py`)
- CLI orchestration → Rule loading: loads rules (evidence: `capa/main.py`)
- CLI orchestration → Capability analysis: analyzes features (evidence: `capa/main.py`)
- Capability analysis → Static matching: dispatches static (evidence: `capa/capabilities/common.py`)
- Capability analysis → Dynamic matching: dispatches dynamic (evidence: `capa/capabilities/common.py`)
- Static matching → Rule evaluator: evaluates rules (evidence: `capa/capabilities/static.py`)
- Dynamic matching → Rule evaluator: evaluates rules (evidence: `capa/capabilities/dynamic.py`)
- Static matching → Result document: records matches (evidence: `capa/capabilities/static.py`)
- Dynamic matching → Result document: records matches (evidence: `capa/capabilities/dynamic.py`)
- CLI orchestration → CLI renderers: renders results (evidence: `capa/main.py`)
- CLI renderers → Result document: formats document (evidence: `capa/render/json.py`)
- CLI orchestration → Feature freezing: can freeze features (evidence: `capa/main.py`)
- Analyst → Browser Explorer: explores results
- Browser Explorer → Result loading: loads documents
- Result loading → Result parser: parses results
- Analyst → IDA plugin: uses analysis plugin
- Analyst → Ghidra plugin: uses analysis plugin
