# fox-it/dissect architecture

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

- Interactive diagram: https://gitdiagram.com/fox-it/dissect
- Repository: https://github.com/fox-it/dissect

## Overview

This repository is Dissect’s meta package, not the implementation of its forensic parsers. Its runtime entry point resolves a requested command from installed Dissect console scripts and dispatches to it; the package dependencies supply the broader framework. The documented analysis workflow uses target tools to access artefacts across image, filesystem, and operating-system formats. Acquire is a related, separately installed tool for creating containers. Parser internals and the detailed analysis pipeline are outside this repository, so the graph shows only documented capabilities and the CLI dispatch supported by source.

Main entry points: [`dissect/cli.py`](https://github.com/fox-it/dissect/blob/main/dissect/cli.py) (Unified CLI), [`pyproject.toml`](https://github.com/fox-it/dissect/blob/main/pyproject.toml) (Framework packages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dispatch["Command dispatch"]
  node_cli["Unified CLI<br/>[cli.py]"]
  node_scripts["Dissect commands"]
end

subgraph group_ecosystem["Forensics ecosystem"]
  node_dependencies["Framework packages<br/>[pyproject.toml]"]
  node_analysis["Target analysis tools"]
  node_formats["Forensic formats"]
  node_acquire["Acquire"]
  node_containers["Lightweight containers"]
end

node_user(("Analyst"))

node_user -->|"runs command"| node_cli
node_cli -->|"resolves and dispatches"| node_scripts
node_dependencies -.->|"provides installed tools"| node_scripts
node_analysis -->|"accesses artefacts across"| node_formats
node_acquire -->|"creates"| node_containers
node_containers -->|"analyses"| node_analysis

click node_cli "https://github.com/fox-it/dissect/blob/main/dissect/cli.py"
click node_dependencies "https://github.com/fox-it/dissect/blob/main/pyproject.toml"

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_scripts toneBlue
class node_dependencies,node_analysis,node_formats,node_acquire,node_containers toneAmber
class node_user toneIndigo
```

## Components

### Command dispatch

- [Unified CLI](https://github.com/fox-it/dissect/blob/main/dissect/cli.py): `dissect/cli.py`
- **Dissect commands**

### Forensics ecosystem

- [Framework packages](https://github.com/fox-it/dissect/blob/main/pyproject.toml): `pyproject.toml`
- **Target analysis tools**
- **Forensic formats**
- **Acquire**
- **Lightweight containers**

### Other components

- **Analyst**

## Connections

- Analyst → Unified CLI: runs command (evidence: `README.md`)
- Unified CLI → Dissect commands: resolves and dispatches (evidence: `dissect/cli.py`)
- Framework packages → Dissect commands: provides installed tools (evidence: `pyproject.toml`)
- Target analysis tools → Forensic formats: accesses artefacts across (evidence: `README.md`)
- Acquire → Lightweight containers: creates (evidence: `README.md`)
- Lightweight containers → Target analysis tools: analyses (evidence: `README.md`)
