# epvh-commits/t3mp3st architecture

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

- Interactive diagram: https://gitdiagram.com/epvh-commits/t3mp3st
- Repository: https://github.com/epvh-commits/t3mp3st

## Overview

T3MP3ST is a self-hosted, multi-agent offensive-security framework. An operator submits an authorized target through the CLI or War Room; Op General plans the mission, operators perform tool-backed testing, and evidence gates and reporting support findings and disclosure. The README also documents CTF, source-code, robotics/OT, smart-contract, cloud, mobile, and binary capabilities. Some of those implementations are not sampled, so their wiring is shown only where the tree or README supports it.

Main entry points: [`src/operators/index.ts`](https://github.com/epvh-commits/t3mp3st/blob/main/src/operators/index.ts) (Operator agents), [`src/server.ts`](https://github.com/epvh-commits/t3mp3st/blob/main/src/server.ts) (War Room API), [`src/general/index.ts`](https://github.com/epvh-commits/t3mp3st/blob/main/src/general/index.ts) (Op General), [`src/llm/index.ts`](https://github.com/epvh-commits/t3mp3st/blob/main/src/llm/index.ts) (LLM backbone)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry"]
  node_cli["CLI<br/>[cli.ts]"]
  node_warroom["War Room API<br/>[server.ts]"]
end

subgraph group_control["Mission control"]
  node_admiral["Op General<br/>[index.ts]"]
  node_mission["Mission engine<br/>[index.ts]"]
  node_orchestrator["Orchestrator<br/>[orchestrator.ts]"]
  node_operators["Operator agents<br/>[index.ts]"]
end

subgraph group_testing["Testing capabilities"]
  node_recon["Recon and attack graph<br/>[attack-graph.ts]"]
  node_arsenal["Tool arsenal<br/>[index.ts]"]
  node_ctf["CTF executor<br/>[ctf_executor.py]"]
  node_whitebox["Python code ingest<br/>[code-ingest.ts]"]
  node_domain["Other domain capabilities"]
end

subgraph group_assurance["Evidence and disclosure"]
  node_evidence["Evidence gate<br/>[gate.ts]"]
  node_bounty["Bounty integration<br/>[bounty.ts]"]
end

subgraph group_support["Agent support"]
  node_llm["LLM backbone<br/>[index.ts]"]
  node_prompts["Operator prompts<br/>[index.ts]"]
  node_resources["Security resources<br/>[index.ts]"]
end

node_operator(("Security operator"))
node_model(("Configured model or local agent"))
node_target(("Authorized target"))
node_platform(("Bounty platform"))

node_operator -->|"submits mission"| node_cli
node_operator -->|"submits mission"| node_warroom
node_cli -->|"requests plan"| node_admiral
node_warroom -->|"accepts directives"| node_admiral
node_warroom -->|"initializes"| node_llm
node_admiral -->|"plans with"| node_llm
node_admiral -->|"executes plan"| node_mission
node_mission -->|"coordinates"| node_orchestrator
node_orchestrator -->|"dispatches work"| node_operators
node_operators -->|"reasons with"| node_llm
node_operators -->|"uses prompts"| node_prompts
node_operators -->|"invokes tools"| node_arsenal
node_arsenal -->|"tests"| node_target
node_operators -->|"performs reconnaissance"| node_recon
node_operators -->|"gates findings"| node_evidence
node_warroom -->|"submits findings"| node_bounty
node_bounty -->|"submits report"| node_platform
node_llm -.->|"sends requests"| node_model
node_mission -->|"offers resources"| node_resources

click node_cli "https://github.com/epvh-commits/t3mp3st/blob/main/src/cli.ts"
click node_warroom "https://github.com/epvh-commits/t3mp3st/blob/main/src/server.ts"
click node_admiral "https://github.com/epvh-commits/t3mp3st/blob/main/src/general/index.ts"
click node_mission "https://github.com/epvh-commits/t3mp3st/blob/main/src/mission/index.ts"
click node_orchestrator "https://github.com/epvh-commits/t3mp3st/blob/main/src/orchestration/orchestrator.ts"
click node_operators "https://github.com/epvh-commits/t3mp3st/blob/main/src/operators/index.ts"
click node_recon "https://github.com/epvh-commits/t3mp3st/blob/main/src/recon/attack-graph.ts"
click node_arsenal "https://github.com/epvh-commits/t3mp3st/blob/main/src/arsenal/index.ts"
click node_ctf "https://github.com/epvh-commits/t3mp3st/blob/main/ctf/executor/ctf_executor.py"
click node_whitebox "https://github.com/epvh-commits/t3mp3st/blob/main/src/recon/code-ingest.ts"
click node_domain "https://github.com/epvh-commits/t3mp3st/tree/main/src"
click node_evidence "https://github.com/epvh-commits/t3mp3st/blob/main/src/evidence/gate.ts"
click node_bounty "https://github.com/epvh-commits/t3mp3st/blob/main/src/integrations/bounty.ts"
click node_llm "https://github.com/epvh-commits/t3mp3st/blob/main/src/llm/index.ts"
click node_prompts "https://github.com/epvh-commits/t3mp3st/blob/main/src/prompts/index.ts"
click node_resources "https://github.com/epvh-commits/t3mp3st/blob/main/src/resources/index.ts"

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_warroom toneBlue
class node_admiral,node_mission,node_orchestrator,node_operators toneAmber
class node_recon,node_arsenal,node_ctf,node_whitebox,node_domain toneMint
class node_evidence,node_bounty toneRose
class node_llm,node_prompts,node_resources,node_operator,node_model,node_target,node_platform toneIndigo
```

## Components

### User entry

- [CLI](https://github.com/epvh-commits/t3mp3st/blob/main/src/cli.ts): `src/cli.ts`
- [War Room API](https://github.com/epvh-commits/t3mp3st/blob/main/src/server.ts): `src/server.ts`

### Mission control

- [Op General](https://github.com/epvh-commits/t3mp3st/blob/main/src/general/index.ts): `src/general/index.ts`
- [Mission engine](https://github.com/epvh-commits/t3mp3st/blob/main/src/mission/index.ts): `src/mission/index.ts`
- [Orchestrator](https://github.com/epvh-commits/t3mp3st/blob/main/src/orchestration/orchestrator.ts): `src/orchestration/orchestrator.ts`
- [Operator agents](https://github.com/epvh-commits/t3mp3st/blob/main/src/operators/index.ts): `src/operators/index.ts`

### Testing capabilities

- [Recon and attack graph](https://github.com/epvh-commits/t3mp3st/blob/main/src/recon/attack-graph.ts): `src/recon/attack-graph.ts`
- [Tool arsenal](https://github.com/epvh-commits/t3mp3st/blob/main/src/arsenal/index.ts): `src/arsenal/index.ts`
- [CTF executor](https://github.com/epvh-commits/t3mp3st/blob/main/ctf/executor/ctf_executor.py): `ctf/executor/ctf_executor.py`
- [Python code ingest](https://github.com/epvh-commits/t3mp3st/blob/main/src/recon/code-ingest.ts): `src/recon/code-ingest.ts`
- [Other domain capabilities](https://github.com/epvh-commits/t3mp3st/tree/main/src): `src`

### Evidence and disclosure

- [Evidence gate](https://github.com/epvh-commits/t3mp3st/blob/main/src/evidence/gate.ts): `src/evidence/gate.ts`
- [Bounty integration](https://github.com/epvh-commits/t3mp3st/blob/main/src/integrations/bounty.ts): `src/integrations/bounty.ts`

### Agent support

- [LLM backbone](https://github.com/epvh-commits/t3mp3st/blob/main/src/llm/index.ts): `src/llm/index.ts`
- [Operator prompts](https://github.com/epvh-commits/t3mp3st/blob/main/src/prompts/index.ts): `src/prompts/index.ts`
- [Security resources](https://github.com/epvh-commits/t3mp3st/blob/main/src/resources/index.ts): `src/resources/index.ts`

### Other components

- **Security operator**
- **Configured model or local agent**
- **Authorized target**
- **Bounty platform**

## Connections

- Security operator → CLI: submits mission
- Security operator → War Room API: submits mission
- CLI → Op General: requests plan
- War Room API → Op General: accepts directives
- War Room API → LLM backbone: initializes
- Op General → LLM backbone: plans with
- Op General → Mission engine: executes plan
- Mission engine → Orchestrator: coordinates
- Orchestrator → Operator agents: dispatches work
- Operator agents → LLM backbone: reasons with
- Operator agents → Operator prompts: uses prompts
- Operator agents → Tool arsenal: invokes tools
- Tool arsenal → Authorized target: tests
- Operator agents → Recon and attack graph: performs reconnaissance
- Operator agents → Evidence gate: gates findings
- War Room API → Bounty integration: submits findings
- Bounty integration → Bounty platform: submits report
- LLM backbone → Configured model or local agent: sends requests
- Mission engine → Security resources: offers resources