# paulinotech1/strix architecture

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

- Interactive diagram: https://gitdiagram.com/paulinotech1/strix
- Repository: https://github.com/paulinotech1/strix

## Overview

Strix is an autonomous AI penetration-testing product, exposed through a local CLI and interactive interfaces, with a separate cloud-facing workflow. A scan takes targets and configuration, prepares a runtime, orchestrates agents and tools to investigate and validate vulnerabilities, then records and presents findings. The README also describes multi-agent collaboration, exploit validation, autofix, and compliance reporting. The graph preserves those capabilities; where implementation was not sampled, relationships are omitted or marked unverified rather than inferred from names alone.

Main entry points: [`strix/core/execution.py`](https://github.com/paulinotech1/strix/blob/main/strix/core/execution.py) (Agent execution), [`strix/report/state.py`](https://github.com/paulinotech1/strix/blob/main/strix/report/state.py) (Run and finding state), [`strix/interface/main.py`](https://github.com/paulinotech1/strix/blob/main/strix/interface/main.py) (CLI entry), [`strix/agents/factory.py`](https://github.com/paulinotech1/strix/blob/main/strix/agents/factory.py) (Agent construction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_cli["CLI entry<br/>[main.py]"]
  node_tui["Interactive TUI<br/>[controller.py]"]
  node_viewer["Run viewer<br/>[server.py]"]
end

subgraph group_scan["Scan orchestration"]
  node_config["Configuration<br/>[loader.py]"]
  node_inputs["Targets and inputs<br/>[inputs.py]"]
  node_runner["Scan runner<br/>[runner.py]"]
  node_execution["Agent execution<br/>[execution.py]"]
  node_runtime["Container runtime<br/>[session_manager.py]"]
  node_model["Model providers<br/>[models.py]"]
end

subgraph group_agents["Agent capabilities"]
  node_factory["Agent construction<br/>[factory.py]"]
  node_coordination["Agent coordination<br/>[agents.py]"]
  node_toolkit["Pentest tools<br/>[tools.py]"]
  node_mcp["MCP connections<br/>[client.py]"]
  node_skills["Agent skills<br/>[__init__.py]"]
end

subgraph group_results["Findings and reports"]
  node_state[("Run and finding state<br/>[state.py]")]
  node_dedupe["Finding deduplication<br/>[dedupe.py]"]
  node_reports["Report generation<br/>[writer.py]"]
  node_telemetry["Scan telemetry<br/>[posthog.py]"]
end

subgraph group_cloud["Cloud and integrations"]
  node_cloud["Cloud scan interface<br/>[runner.py]"]
  node_cloudapi["Cloud HTTP API<br/>[http.py]"]
end

node_user(("User"))
node_external(("LLM provider"))
node_repo(("Target application"))

node_user -->|"starts scan"| node_cli
node_cli -->|"loads settings"| node_config
node_cli -->|"prepares targets"| node_inputs
node_cli -.->|"launches scan"| node_runner
node_runner -.->|"runs agents"| node_execution
node_execution -->|"uses targets"| node_inputs
node_execution -->|"coordinates agents"| node_coordination
node_execution -.->|"configures model"| node_model
node_execution -.->|"uses runtime"| node_runtime
node_factory -->|"registers tools"| node_toolkit
node_factory -->|"enables MCP"| node_mcp
node_factory -->|"loads skills"| node_skills
node_user -->|"assesses"| node_repo
node_toolkit -.->|"tests target"| node_repo
node_mcp -.->|"calls tools"| node_external
node_execution -.->|"records results"| node_state
node_state -->|"deduplicates findings"| node_dedupe
node_state -->|"writes reports"| node_reports
node_state -->|"sends scan data"| node_telemetry
node_state -->|"serves run data"| node_viewer
node_user -.->|"steers scan"| node_tui
node_tui -.->|"opens viewer"| node_viewer
node_user -->|"requests cloud scan"| node_cloud
node_cloud -.->|"uses API"| node_cloudapi

click node_cli "https://github.com/paulinotech1/strix/blob/main/strix/interface/main.py"
click node_tui "https://github.com/paulinotech1/strix/blob/main/strix/interface/tui/backend/controller.py"
click node_viewer "https://github.com/paulinotech1/strix/blob/main/strix/interface/viewer/server.py"
click node_config "https://github.com/paulinotech1/strix/blob/main/strix/config/loader.py"
click node_inputs "https://github.com/paulinotech1/strix/blob/main/strix/core/inputs.py"
click node_runner "https://github.com/paulinotech1/strix/blob/main/strix/core/runner.py"
click node_execution "https://github.com/paulinotech1/strix/blob/main/strix/core/execution.py"
click node_runtime "https://github.com/paulinotech1/strix/blob/main/strix/runtime/session_manager.py"
click node_model "https://github.com/paulinotech1/strix/blob/main/strix/config/models.py"
click node_factory "https://github.com/paulinotech1/strix/blob/main/strix/agents/factory.py"
click node_coordination "https://github.com/paulinotech1/strix/blob/main/strix/core/agents.py"
click node_toolkit "https://github.com/paulinotech1/strix/blob/main/strix/tools/proxy/tools.py"
click node_mcp "https://github.com/paulinotech1/strix/blob/main/strix/tools/mcp/client.py"
click node_skills "https://github.com/paulinotech1/strix/blob/main/strix/skills/__init__.py"
click node_state "https://github.com/paulinotech1/strix/blob/main/strix/report/state.py"
click node_dedupe "https://github.com/paulinotech1/strix/blob/main/strix/report/dedupe.py"
click node_reports "https://github.com/paulinotech1/strix/blob/main/strix/report/writer.py"
click node_telemetry "https://github.com/paulinotech1/strix/blob/main/strix/telemetry/posthog.py"
click node_cloud "https://github.com/paulinotech1/strix/blob/main/strix/interface/cloud/runner.py"
click node_cloudapi "https://github.com/paulinotech1/strix/blob/main/strix/interface/cloud/http.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_tui,node_viewer,node_user toneBlue
class node_config,node_inputs,node_runner,node_execution,node_runtime,node_model toneAmber
class node_factory,node_coordination,node_toolkit,node_mcp,node_skills toneMint
class node_state,node_dedupe,node_reports,node_telemetry toneRose
class node_cloud,node_cloudapi,node_external,node_repo toneIndigo
```

## Components

### User interfaces

- [CLI entry](https://github.com/paulinotech1/strix/blob/main/strix/interface/main.py): `strix/interface/main.py`
- [Interactive TUI](https://github.com/paulinotech1/strix/blob/main/strix/interface/tui/backend/controller.py): `strix/interface/tui/backend/controller.py`
- [Run viewer](https://github.com/paulinotech1/strix/blob/main/strix/interface/viewer/server.py): `strix/interface/viewer/server.py`

### Scan orchestration

- [Configuration](https://github.com/paulinotech1/strix/blob/main/strix/config/loader.py): `strix/config/loader.py`
- [Targets and inputs](https://github.com/paulinotech1/strix/blob/main/strix/core/inputs.py): `strix/core/inputs.py`
- [Scan runner](https://github.com/paulinotech1/strix/blob/main/strix/core/runner.py): `strix/core/runner.py`
- [Agent execution](https://github.com/paulinotech1/strix/blob/main/strix/core/execution.py): `strix/core/execution.py`
- [Container runtime](https://github.com/paulinotech1/strix/blob/main/strix/runtime/session_manager.py): `strix/runtime/session_manager.py`
- [Model providers](https://github.com/paulinotech1/strix/blob/main/strix/config/models.py): `strix/config/models.py`

### Agent capabilities

- [Agent construction](https://github.com/paulinotech1/strix/blob/main/strix/agents/factory.py): `strix/agents/factory.py`
- [Agent coordination](https://github.com/paulinotech1/strix/blob/main/strix/core/agents.py): `strix/core/agents.py`
- [Pentest tools](https://github.com/paulinotech1/strix/blob/main/strix/tools/proxy/tools.py): `strix/tools/proxy/tools.py`
- [MCP connections](https://github.com/paulinotech1/strix/blob/main/strix/tools/mcp/client.py): `strix/tools/mcp/client.py`
- [Agent skills](https://github.com/paulinotech1/strix/blob/main/strix/skills/__init__.py): `strix/skills/__init__.py`

### Findings and reports

- [Run and finding state](https://github.com/paulinotech1/strix/blob/main/strix/report/state.py): `strix/report/state.py`
- [Finding deduplication](https://github.com/paulinotech1/strix/blob/main/strix/report/dedupe.py): `strix/report/dedupe.py`
- [Report generation](https://github.com/paulinotech1/strix/blob/main/strix/report/writer.py): `strix/report/writer.py`
- [Scan telemetry](https://github.com/paulinotech1/strix/blob/main/strix/telemetry/posthog.py): `strix/telemetry/posthog.py`

### Cloud and integrations

- [Cloud scan interface](https://github.com/paulinotech1/strix/blob/main/strix/interface/cloud/runner.py): `strix/interface/cloud/runner.py`
- [Cloud HTTP API](https://github.com/paulinotech1/strix/blob/main/strix/interface/cloud/http.py): `strix/interface/cloud/http.py`

### Other components

- **User**
- **LLM provider**
- **Target application**

## Connections

- User → CLI entry: starts scan (evidence: `README.md`)
- CLI entry → Configuration: loads settings (evidence: `strix/interface/main.py`)
- CLI entry → Targets and inputs: prepares targets (evidence: `strix/interface/main.py`)
- CLI entry → Scan runner: launches scan
- Scan runner → Agent execution: runs agents
- Agent execution → Targets and inputs: uses targets (evidence: `strix/core/execution.py`)
- Agent execution → Agent coordination: coordinates agents (evidence: `strix/core/execution.py`)
- Agent execution → Model providers: configures model
- Agent execution → Container runtime: uses runtime
- Agent construction → Pentest tools: registers tools (evidence: `strix/agents/factory.py`)
- Agent construction → MCP connections: enables MCP (evidence: `strix/agents/factory.py`)
- Agent construction → Agent skills: loads skills (evidence: `strix/agents/factory.py`)
- User → Target application: assesses (evidence: `README.md`)
- Pentest tools → Target application: tests target
- MCP connections → LLM provider: calls tools
- Agent execution → Run and finding state: records results
- Run and finding state → Finding deduplication: deduplicates findings (evidence: `strix/report/dedupe.py`)
- Run and finding state → Report generation: writes reports (evidence: `strix/report/state.py`)
- Run and finding state → Scan telemetry: sends scan data (evidence: `strix/telemetry/posthog.py`)
- Run and finding state → Run viewer: serves run data (evidence: `strix/interface/viewer/server.py`)
- User → Interactive TUI: steers scan
- Interactive TUI → Run viewer: opens viewer (evidence: `strix/interface/tui/backend/controller.py`)
- User → Cloud scan interface: requests cloud scan (evidence: `README.md`)
- Cloud scan interface → Cloud HTTP API: uses API
