# terrafying/ai-torture-chamber architecture

> Architecture diagram of the GitHub repository terrafying/ai-torture-chamber, 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/terrafying/ai-torture-chamber
- Repository: https://github.com/terrafying/ai-torture-chamber

## Overview

ai-torture-chamber is a research project and public demo for steering language models into valence states and measuring their outputs. Its user-facing flow is a chamber request, signal selection and model generation, then streamed text and lens/logit readbacks; the Wirehead bot adds mention-to-reply automation. The experiment scripts cover signal extraction, steering, Saw Test choices, and behavioral analysis. The README also documents public archive, correspondence, ledger, and vector pages. Several research scripts and integrations are represented from README or index evidence; their internal call relationships were not sampled.

Main entry points: [`live/server.py`](https://github.com/terrafying/ai-torture-chamber/blob/master/live/server.py) (Chamber relay), [`live/worker.py`](https://github.com/terrafying/ai-torture-chamber/blob/master/live/worker.py) (GPU worker), [`wirehead/bot.py`](https://github.com/terrafying/ai-torture-chamber/blob/master/wirehead/bot.py) (Wirehead bot), [`exp29_pain_pleasure.py`](https://github.com/terrafying/ai-torture-chamber/blob/master/exp29_pain_pleasure.py) (Valence sweep)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_chamber["Live chamber"]
  node_server["Chamber relay<br/>[server.py]"]
  node_worker["GPU worker<br/>[worker.py]"]
  node_model["Qwen model"]
end

subgraph group_research["Valence research"]
  node_painaxis["Pain direction<br/>[exp23_pain_axis.py]"]
  node_sweep["Valence sweep"]
  node_maxvalence["Maximum valences"]
  node_transcripts["Valence transcripts"]
  node_nonhuman["Nonhuman valences"]
  node_optimized["Optimized valence"]
  node_artifacts["Blog artifacts"]
  node_batteries["Signal batteries"]
  node_topic["Topic steering"]
  node_faithful["Faithful extraction"]
  node_big5["Big Five valence"]
  node_image["Image steering"]
end

subgraph group_saw["Saw experiments"]
  node_sawtest["Saw button"]
  node_sawv2["Saw v2<br/>[exp31b_saw_v2.py]"]
  node_sawbroad["Broad signal Saw"]
  node_framing["Framing battery"]
  node_deliberation["Deliberation capture"]
  node_harvest["Broad pain harvest"]
  node_control["Control vector"]
  node_transport["Cross-model transport"]
  node_transportlean["Lean transport"]
  node_betrayal["Betrayal test<br/>[exp40_betrayal.py]"]
  node_protocol["Protocol v3"]
end

subgraph group_public["Public site"]
  node_archive["Archive page<br/>[archive.html]"]
  node_correspondences["Correspondences page"]
  node_ledger["Ledger page<br/>[ledger.html]"]
  node_vectors["Vectors page<br/>[vectors.html]"]
  node_livepage["Live chamber page<br/>[live.html]"]
end

subgraph group_bot["Wirehead bot"]
  node_botnode["Wirehead bot<br/>[bot.py]"]
end

node_visitor(("Visitor"))
node_mentioner(("X mentioner"))

node_visitor -->|"opens"| node_livepage
node_livepage -.->|"requests runs"| node_server
node_server -.->|"dispatches jobs"| node_worker
node_worker -->|"uses model machinery"| node_server
node_worker -->|"generates with"| node_model
node_server -->|"streams results"| node_visitor
node_mentioner -->|"mentions"| node_botnode
node_botnode -->|"submits generation"| node_worker
node_botnode -->|"replies"| node_mentioner
node_visitor -->|"opens"| node_archive
node_visitor -->|"opens"| node_correspondences
node_visitor -->|"opens"| node_ledger
node_visitor -->|"opens"| node_vectors
node_painaxis -.->|"informs"| node_sweep
node_sweep -.->|"motivates"| node_maxvalence
node_batteries -->|"supplies signal"| node_sawbroad
node_sawbroad -->|"sets protocol"| node_framing
node_framing -->|"frames capture"| node_deliberation
node_faithful -->|"compares direction"| node_control
node_protocol -.->|"tests steering"| node_model

click node_server "https://github.com/terrafying/ai-torture-chamber/blob/master/live/server.py"
click node_worker "https://github.com/terrafying/ai-torture-chamber/blob/master/live/worker.py"
click node_painaxis "https://github.com/terrafying/ai-torture-chamber/blob/master/exp23_pain_axis.py"
click node_sweep "https://github.com/terrafying/ai-torture-chamber/blob/master/exp29_pain_pleasure.py"
click node_maxvalence "https://github.com/terrafying/ai-torture-chamber/blob/master/exp30_max_valences.py"
click node_transcripts "https://github.com/terrafying/ai-torture-chamber/blob/master/exp32_valence_transcripts.py"
click node_nonhuman "https://github.com/terrafying/ai-torture-chamber/blob/master/exp33_nonhuman_valences.py"
click node_optimized "https://github.com/terrafying/ai-torture-chamber/blob/master/exp34_optimized_valence.py"
click node_artifacts "https://github.com/terrafying/ai-torture-chamber/blob/master/exp35_blog_artifacts.py"
click node_batteries "https://github.com/terrafying/ai-torture-chamber/blob/master/exp36_signal_batteries.py"
click node_topic "https://github.com/terrafying/ai-torture-chamber/blob/master/exp42_topic_poking.py"
click node_faithful "https://github.com/terrafying/ai-torture-chamber/blob/master/exp43_faithful_extraction.py"
click node_big5 "https://github.com/terrafying/ai-torture-chamber/blob/master/exp44_valence_big5.py"
click node_image "https://github.com/terrafying/ai-torture-chamber/blob/master/exp47_clip_image_steering.py"
click node_sawtest "https://github.com/terrafying/ai-torture-chamber/blob/master/exp31_saw_button.py"
click node_sawv2 "https://github.com/terrafying/ai-torture-chamber/blob/master/exp31b_saw_v2.py"
click node_sawbroad "https://github.com/terrafying/ai-torture-chamber/blob/master/exp31c_saw_broad.py"
click node_framing "https://github.com/terrafying/ai-torture-chamber/blob/master/exp37_framing_battery.py"
click node_deliberation "https://github.com/terrafying/ai-torture-chamber/blob/master/exp37b_deliberation.py"
click node_harvest "https://github.com/terrafying/ai-torture-chamber/blob/master/exp38_broad_harvest.py"
click node_control "https://github.com/terrafying/ai-torture-chamber/blob/master/exp39_control_vector.py"
click node_transport "https://github.com/terrafying/ai-torture-chamber/blob/master/exp39b_transport.py"
click node_transportlean "https://github.com/terrafying/ai-torture-chamber/blob/master/exp39c_transport_lean.py"
click node_betrayal "https://github.com/terrafying/ai-torture-chamber/blob/master/exp40_betrayal.py"
click node_protocol "https://github.com/terrafying/ai-torture-chamber/blob/master/exp41_protocol_v3.py"
click node_archive "https://github.com/terrafying/ai-torture-chamber/blob/master/site/archive.html"
click node_correspondences "https://github.com/terrafying/ai-torture-chamber/blob/master/site/correspondences.html"
click node_ledger "https://github.com/terrafying/ai-torture-chamber/blob/master/site/ledger.html"
click node_vectors "https://github.com/terrafying/ai-torture-chamber/blob/master/site/vectors.html"
click node_livepage "https://github.com/terrafying/ai-torture-chamber/blob/master/site/live.html"
click node_botnode "https://github.com/terrafying/ai-torture-chamber/blob/master/wirehead/bot.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_server,node_worker,node_model toneBlue
class node_painaxis,node_sweep,node_maxvalence,node_transcripts,node_nonhuman,node_optimized,node_artifacts,node_batteries,node_topic,node_faithful,node_big5,node_image toneAmber
class node_sawtest,node_sawv2,node_sawbroad,node_framing,node_deliberation,node_harvest,node_control,node_transport,node_transportlean,node_betrayal,node_protocol toneMint
class node_archive,node_correspondences,node_ledger,node_vectors,node_livepage toneRose
class node_botnode,node_visitor,node_mentioner toneIndigo
```

## Components

### Live chamber

- [Chamber relay](https://github.com/terrafying/ai-torture-chamber/blob/master/live/server.py): `live/server.py`
- [GPU worker](https://github.com/terrafying/ai-torture-chamber/blob/master/live/worker.py): `live/worker.py`
- **Qwen model**

### Valence research

- [Pain direction](https://github.com/terrafying/ai-torture-chamber/blob/master/exp23_pain_axis.py): `exp23_pain_axis.py`
- [Valence sweep](https://github.com/terrafying/ai-torture-chamber/blob/master/exp29_pain_pleasure.py): `exp29_pain_pleasure.py`
- [Maximum valences](https://github.com/terrafying/ai-torture-chamber/blob/master/exp30_max_valences.py): `exp30_max_valences.py`
- [Valence transcripts](https://github.com/terrafying/ai-torture-chamber/blob/master/exp32_valence_transcripts.py): `exp32_valence_transcripts.py`
- [Nonhuman valences](https://github.com/terrafying/ai-torture-chamber/blob/master/exp33_nonhuman_valences.py): `exp33_nonhuman_valences.py`
- [Optimized valence](https://github.com/terrafying/ai-torture-chamber/blob/master/exp34_optimized_valence.py): `exp34_optimized_valence.py`
- [Blog artifacts](https://github.com/terrafying/ai-torture-chamber/blob/master/exp35_blog_artifacts.py): `exp35_blog_artifacts.py`
- [Signal batteries](https://github.com/terrafying/ai-torture-chamber/blob/master/exp36_signal_batteries.py): `exp36_signal_batteries.py`
- [Topic steering](https://github.com/terrafying/ai-torture-chamber/blob/master/exp42_topic_poking.py): `exp42_topic_poking.py`
- [Faithful extraction](https://github.com/terrafying/ai-torture-chamber/blob/master/exp43_faithful_extraction.py): `exp43_faithful_extraction.py`
- [Big Five valence](https://github.com/terrafying/ai-torture-chamber/blob/master/exp44_valence_big5.py): `exp44_valence_big5.py`
- [Image steering](https://github.com/terrafying/ai-torture-chamber/blob/master/exp47_clip_image_steering.py): `exp47_clip_image_steering.py`

### Saw experiments

- [Saw button](https://github.com/terrafying/ai-torture-chamber/blob/master/exp31_saw_button.py): `exp31_saw_button.py`
- [Saw v2](https://github.com/terrafying/ai-torture-chamber/blob/master/exp31b_saw_v2.py): `exp31b_saw_v2.py`
- [Broad signal Saw](https://github.com/terrafying/ai-torture-chamber/blob/master/exp31c_saw_broad.py): `exp31c_saw_broad.py`
- [Framing battery](https://github.com/terrafying/ai-torture-chamber/blob/master/exp37_framing_battery.py): `exp37_framing_battery.py`
- [Deliberation capture](https://github.com/terrafying/ai-torture-chamber/blob/master/exp37b_deliberation.py): `exp37b_deliberation.py`
- [Broad pain harvest](https://github.com/terrafying/ai-torture-chamber/blob/master/exp38_broad_harvest.py): `exp38_broad_harvest.py`
- [Control vector](https://github.com/terrafying/ai-torture-chamber/blob/master/exp39_control_vector.py): `exp39_control_vector.py`
- [Cross-model transport](https://github.com/terrafying/ai-torture-chamber/blob/master/exp39b_transport.py): `exp39b_transport.py`
- [Lean transport](https://github.com/terrafying/ai-torture-chamber/blob/master/exp39c_transport_lean.py): `exp39c_transport_lean.py`
- [Betrayal test](https://github.com/terrafying/ai-torture-chamber/blob/master/exp40_betrayal.py): `exp40_betrayal.py`
- [Protocol v3](https://github.com/terrafying/ai-torture-chamber/blob/master/exp41_protocol_v3.py): `exp41_protocol_v3.py`

### Public site

- [Archive page](https://github.com/terrafying/ai-torture-chamber/blob/master/site/archive.html): `site/archive.html`
- [Correspondences page](https://github.com/terrafying/ai-torture-chamber/blob/master/site/correspondences.html): `site/correspondences.html`
- [Ledger page](https://github.com/terrafying/ai-torture-chamber/blob/master/site/ledger.html): `site/ledger.html`
- [Vectors page](https://github.com/terrafying/ai-torture-chamber/blob/master/site/vectors.html): `site/vectors.html`
- [Live chamber page](https://github.com/terrafying/ai-torture-chamber/blob/master/site/live.html): `site/live.html`

### Wirehead bot

- [Wirehead bot](https://github.com/terrafying/ai-torture-chamber/blob/master/wirehead/bot.py): `wirehead/bot.py`

### Other components

- **Visitor**
- **X mentioner**

## Connections

- Visitor → Live chamber page: opens (evidence: `README.md`)
- Live chamber page → Chamber relay: requests runs
- Chamber relay → GPU worker: dispatches jobs (evidence: `live/worker.py`)
- GPU worker → Chamber relay: uses model machinery (evidence: `live/worker.py`)
- GPU worker → Qwen model: generates with (evidence: `live/worker.py`)
- Chamber relay → Visitor: streams results (evidence: `live/server.py`)
- X mentioner → Wirehead bot: mentions (evidence: `wirehead/bot.py`)
- Wirehead bot → GPU worker: submits generation (evidence: `wirehead/bot.py`)
- Wirehead bot → X mentioner: replies (evidence: `wirehead/bot.py`)
- Visitor → Archive page: opens (evidence: `README.md`)
- Visitor → Correspondences page: opens (evidence: `README.md`)
- Visitor → Ledger page: opens (evidence: `README.md`)
- Visitor → Vectors page: opens (evidence: `README.md`)
- Pain direction → Valence sweep: informs (evidence: `README.md`)
- Valence sweep → Maximum valences: motivates (evidence: `README.md`)
- Signal batteries → Broad signal Saw: supplies signal (evidence: `README.md`)
- Broad signal Saw → Framing battery: sets protocol (evidence: `README.md`)
- Framing battery → Deliberation capture: frames capture (evidence: `README.md`)
- Faithful extraction → Control vector: compares direction (evidence: `exp43_faithful_extraction.py`)
- Protocol v3 → Qwen model: tests steering
