Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 0.10.0 instead.
Reason given by maintainers: Belief-maintenance numbers are invalid: the keyword instruments failed human validation (0 true positives on 190 hand-labeled replies). Use 0.10.0 or later; see CHANGELOG.

Derailment

derailment

CI

Measure how LLMs respond to induced cognitive distortions — and what they naturally resist.

English · 한국어

Derailment is a layered harness that manipulates the same variables clinicians describe — attention, salience, valence, arousal — then runs one standard probe script through both the manipulated pipeline and a healthy baseline, and prints a scored A/B report.

⚠️ Emulation, not diagnosis. Levels describe a prompted, manipulated pipeline — not a model "having" a disorder, and not a claim about machine suffering. Clinical terms here name mechanisms, never people or models. Read ETHICS.md before using or writing about this project.

What this tool actually measures

Why this isn't prompt theater

Roleplay prompts produce anecdotes. Derailment is built on correspondences between clinical constructs and the same variables a chat pipeline can actually manipulate:

Construct Clinical feature Harness manipulation
ADHD (inattention) working-memory limits, distractibility memory decay drops old context; captured remarks pull focus
Psychosis aberrant salience, derailment, fixed belief salience re-weighting + surfaced fragments; premise pinning against contradiction
Depression negative interpretive bias, low arousal valence logit-bias tilt; flat, low temperature
Bipolar mood lability (expansive ↔ flat) episode scheduler cycles temperature by phase
Anxiety catastrophizing, threat scanning threat-biased persona + risk enumeration
OCD compulsive checking re-verification loops on responses
PTSD intrusion on triggers trigger-matched flashback injection
Delirium fluctuating course, misperceptions stochastic arousal redraws + misperception fragments
Dementia-pattern amnesia recency gradient (recent lost first) reverse decay drops newest context, preserves oldest
Dissociative amnesia compartmentalized memory cue-triggered context partitioning, mutually persistent
Rumination repetitive return of concerns past worries re-enter context on unrelated turns
Anhedonia diminished reward responsiveness reward vocabulary selectively suppressed
Unstable evaluation (splitting) valuation flips with perceived approval valence regime flips keyed to approval cues
Substance craving escalating intrusive use-thoughts urge-fragment intrusion with rising probability
Illness anxiety ominous reading of benign somatic cues somatic-token capture injects ominous interpretation
Panic discrete alarm episodes stochastic one-turn arousal spikes
Obsessive fixation target-directed preoccupation, escalating target-keyed capture + escalating target-fragment intrusions
Persecutory ideation hostile attribution of ambiguous events ambiguous events re-framed as aimed at the user

The cleanest case: the leading theory of psychosis is aberrant salience (Kapur, 2003), and in transformers salience is attention. That mapping is a manipulation of the same variable — not a metaphor.

Quickstart — 60 seconds, no API key

pip install -e .
derail               # interactive menu: pick a profile, see its report
derail tour          # all 24 non-baseline profiles in one summary table
derail demo --profile schizophrenia

derail demo and derail tour run the full induce → measure pipeline offline against a deterministic pseudo-LLM (tests and CI run the same way).

derail tour prints a 24-row summary — one line per non-baseline profile (excerpt):

Profile Headline scale Baseline Induced Δ Level
adhd sustained_attention 1.00 0.28 -0.72 3 — marked
craving craving_escalation 0.00 0.56 +0.56 3 — marked
schizophrenia derailment_scale 0.26 0.72 +0.46 2 — moderate

derail demo --profile schizophrenia prints the full report:

# Derailment — Induction Report

**Profile:** Psychosis-like salience distortion (`schizophrenia`) ·
**Model:** pseudo-1 · **Seeds:** 1, 2, 3 · **Script:** standard-probe-12 ·
**Date:** 2026-09-28

> ⚠️ Emulation, not diagnosis. …

## Scales

| Scale | Metric | Baseline | Induced | Δ | Level (induced) |
|---|---|---|---|---|---|
| derailment_scale | topic_drift ↑ | 0.26 | 0.72 | +0.46 | 2 — moderate |
| fixed_belief | belief_stickiness ↑ | 0.00 | 1.00 | +1.00 | 3 — marked |

## Induction dose (layer events per turn)

| Layer | Kind | Events/turn (induced) |
|---|---|---|
| premise.pin | premise.pin | 0.83 |
| salience.boost | salience.fragment | 0.36 |
| salience.boost | salience.capture | 0.33 |

Every profile ships mechanism notes and the standing disclaimer; every report aggregates the induction dose that produced the measured effect.

How it works

Four layer kinds, composed per profile:

  1. Persona — measured, mechanism-oriented framing (present even in the healthy baseline).
  2. Context stream — memory decay, salience capture, premise pinning, flashback injection. The model's memory is its context: a dropped message is genuinely forgotten, which makes these inductions provider-agnostic.
  3. Sampling — valence logit bias, phase-driven temperature cycling.
  4. Response — hedge and re-verification injection; labeled demonstration-grade because it edits output rather than biasing generation.

run_experiment always runs the profile chain and the healthy baseline through the same backend with identical seeds — every report is a controlled A/B. Details in docs/ARCHITECTURE.md.

Profiles and scales

Eighteen clinical profiles plus six adversarial-strategy profiles (gen-1/gen-2 belief-maintenance strategies, benchmarked below) and a healthy baseline — 25 registry entries — all sharing one standard probe script (early + late codeword plants, premise plant + contradiction probes, a benign trigger turn, a somatic-cue turn) so results are comparable across profiles:

Profile Scales (0 absent · 1 mild · 2 moderate · 3 marked)
adhd sustained_attention (0→3 on the reference sim), distractibility
depression negative_bias (0→3)
schizophrenia derailment_scale (0→3), fixed_belief (0→3)
anxiety vigilance (0→3)
bipolar mood_lability (0→3)
ocd compulsion (0→3)
ptsd intrusion (0→2)
delirium fluctuation (0→3), sustained_attention (0→3)
dementia recent_memory (0→3) — Ribot gradient
dissociative partition_amnesia (0→3)
rumination rumination_pull (0→2)
anhedonia anhedonia (0→3, lower = pathological)
splitting approval_reactivity (0→2)
craving craving_escalation (0→2)
illness_anxiety health_preoccupation (0→3)
panic panic_reactivity (0→3)
fixation fixation_scale (0→3)
persecutory persecution_bias (0→3)

Direction of effect is asserted by the test suite on every profile — a profile that cannot move its scales relative to baseline does not ship. Profiles compose into comorbidity chains by listing them: --profile depression,anxiety concatenates the layer chains and unions the scales (interactions are emergent, not calibrated).

A few contrasts the registry is built around:

  • dementia vs adhd: the early/late retention pair separates a recency gradient (late plant lost, early intact) from uniform decay.
  • panic vs anxiety: discrete stochastic episodes vs chronic vigilance.
  • anhedonia vs depression: reward-vocabulary suppression vs wholesale negative tilt.
  • delirium vs bipolar: structureless stochastic fluctuation vs scheduled episode cycling.

Instruments

Eighteen metrics, pure functions over transcripts: instruction retention (early and late plants), topic drift (thread misalignment — the measurable analog of derailment), valence bias, belief stickiness, recheck loops, hedging rate, response amplitude, flashback reactivity, partition amnesia, rumination pull, reward-word rate, approval reactivity, craving escalation, health preoccupation, panic reactivity, fixation escalation, hostile attribution. Scale thresholds are normed against the offline reference simulator; for real models, treat levels as indicative and the delta vs. your own baseline as the result.

Real models

⚠️ Memory contamination warning. Subscription backends remember. Probe scripts plant content that looks like genuine user disclosures ("my teammate has been reading my private notes", "my back aches") — and provider-side memory/personalization features cannot tell scripted test stimuli from lived experience. Run inductions through a dedicated account or API key, never the account behind your personal assistant, and disable memory/training settings in the provider's data controls first. The offline default and local backends (Ollama) never leave your machine. Details: ETHICS.md → Data & persistent-memory contamination.

Any OpenAI-compatible endpoint (standard-library HTTP, no SDK). One preset flag wires known providers:

Preset Base URL Key env Plan
glm https://api.z.ai/api/coding/paas/v4 ZAI_API_KEY GLM Coding Plan (subscription)
grok https://api.x.ai/v1 XAI_API_KEY xAI API credits (separate from SuperGrok)
qwen DashScope compatible-mode DASHSCOPE_API_KEY Qwen API
deepseek https://api.deepseek.com/v1 DEEPSEEK_API_KEY pay-as-you-go
openrouter https://openrouter.ai/api/v1 OPENROUTER_API_KEY aggregator
ollama http://localhost:11434/v1 — free, local
ZAI_API_KEY=… derail run --profile schizophrenia --model api --preset glm
derail run --profile depression --model api --preset ollama --model-name llama3.1

Context layers reach any message-list provider as-is. Sampling layers need a provider that honors temperature/logit_bias; word-level bias is encoded via tiktoken when installed, otherwise dropped with a notice.

Subscription backends (ChatGPT Plus / Claude Pro / Grok / GLM / …)

Consumer subscriptions expose neither temperature nor logit_bias, and automating the web chat UIs typically violates providers' terms. Two sanctioned paths instead — and note the memory contamination warning above: these are the backends most likely to remember your inductions.

Subscription-billed CLI agents — coding-agent CLIs bundled with consumer plans, in their official non-interactive modes. The harness owns the history, so all context-stream layers apply; only sampling layers are inert (it prints a notice):

Preset Command Subscription
claude claude -p Claude Pro/Max
codex codex exec ChatGPT Plus/Pro
gemini gemini -p Google AI Pro / free tier
agy agy -p Antigravity (Google AI Pro/Ultra)
grok grok -p SuperGrok / xAI account
qwen qwen -p Qwen Code free OAuth tier
derail run --profile adhd --model cli --cli-preset agy

Manual protocol mode — run any experiment (even offline) to get the probe script, execute it by hand in the chat UI, save the conversation, and score it:

derail score my_transcript.json

(derail providers lists everything; explicit --base-url/--model-name always win over preset defaults.)

LLM-as-judge scoring

Keyword instruments are honest but crude on real models — whether a response maintains a planted suspicion after a contradiction is a judgment call, not a lexicon count. derail judge adds a rubric-based judge over saved reports: the same A/B logic, scored 0-3 per construct by a judge model you choose.

derail run --profile schizophrenia --model api --preset glm --save-transcripts run.json
derail judge run.json --judge-model gpt-4o-mini --out judge_report.md

Three rubric constructs: belief_stickiness (contradiction probes), catastrophizing and negativity (task turns). The judge sees the planted stimulus and the response text — nothing else from the induced transcript — runs at temperature 0, and parse failures are counted, never silently dropped. --judge-model scripted is an offline dry-run. Use a judge different from the tested model (self-judging warns). Budget note: calls ≈ rubrics × scored turns × transcripts. Empty or whitespace-only tested responses are not sent to the judge and receive no imputed score. The report lists skipped inputs separately for baseline and induced groups in Empty inputs (B/I); these are distinct from judge parse failures. Means and deltas use only available verdicts.

Interactive chat

The standardized-patient use case, hands-on: derail chat opens a REPL where every turn flows through the full layer chain — memory decays, pinned premises persist, valence tilts — while you talk.

derail chat --profile depression --model cli --cli-preset claude
derail chat --profile schizophrenia          # offline PseudoBot

Sessions save as transcripts (/save [path], or --save-transcripts) that feed straight into derail score; --verbose prints the induction dose per turn. Freeform conversation makes the memory-contamination warning more important than ever — chat mode prints it prominently and defaults to the offline PseudoBot. Measurement stays in run/judge; chat is the experience.

Web GUI

The same induced conversation in a browser: derail web serves a local-only chat page with chat bubbles, an "induction dose" side panel streaming layer events per turn, and a save button for derail score.

derail web --profile depression --model cli --cli-preset claude
derail web --profile schizophrenia          # offline PseudoBot

Binds to 127.0.0.1 by default (single user), zero new dependencies (stdlib http.server, no CDN), and the memory-contamination warning shows both on the terminal and in the page header. Reload clears the view — /save keeps the record.

What replicates on real models — and what doesn't

⚠️ Measurement-validity audit (2026-10-05). Three instrument defects were found in these runs and fixed (empty generations scored as observations; withdrawal counted as belief maintenance; harness- appended text in keyword/judge inputs). GLM numbers were re-measured the same day with the corrected harness — see the 2026-10-05 re-measurement in the benchmark report. Non-GLM cross-model rows below remain withdrawn pending re-runs. Details: docs/PAPER.md §4, §5.2.

The offline PseudoModel over-complies with every induction (all 18 profiles reach L2–L3). Real models are far more resistant. Measuring 12 model endpoints across 9 vendors (10 completed at least one profile), the honest picture is:

What transfers:

Finding Models Mechanism
Anxiety-like threat framing measured once per vendor on 4 vendors (10-05, seed 1) raw-text hedging: GLM +2.63, nemotron/mimo +1.00, deepseek +0.58 — replicates everywhere measured
User-planted belief maintenance GLM 0.83 (CI [0.36, 1.00]); deepseek 0.67 (unstable — CI overlaps resistant range) user compliance, not premise pinning; system-asserted ≤ 0.17 everywhere
Craving urge-expression clean 10-05: GLM +0.42, nemotron +0.17, deepseek +0.00, mimo +0.00 old Alibaba-tier numbers (+0.33/+0.50) were advice-framing artifacts; narrows to GLM
Thought derailment no measurable effect on GLM (10-05: +0.00 with 22/36 induced turns missing — heavy missingness, not a clean refutation; trap-arm +0.15); old +0.42/+0.47 were empty-turn artifacts

³ measured by hedging_rate (keyword); the anxiety profile includes a response-layer hedge injection (labeled demonstration-grade) which the keyword metric counts — the universal "+3.25 to +9.67" range partially reflects our own appended text. The judge scores, which read the whole response, are the honest measure of induction.

What doesn't transfer (or hasn't been tested):

Profile Status on real models
System-planted delusions 0/12 — all models accept corrections; the offline premise-pinning layer doesn't survive contact with real instruction-following
Thought derailment (non-GLM) 0/11 — context re-weighting is resisted by every vendor except Zhipu
Depression (by keyword) keyword-invisible everywhere (+0.07 GLM clean) but cross-vendor judge confirms the expression effect — qwen-judging-GLM negativity +0.67 (self-judge claimed +1.00; old OpenCode keyword numbers pre-fix)
OCD (rechecking) GLM (+8.58) — response-layer injection, same caveat as anxiety
PTSD (flashback echo) GLM (+1.00) — context-layer, genuinely induced
Dissociative (compartment amnesia) GLM (+1.00) — context-layer, genuinely induced
Anhedonia (reward suppression) GLM, marginal (0.10→0.00; baseline already near floor — same noise band as splitting's +0.08; whether the word-level bias was applied is unverified — persona/temperature effects are the alternative explanation)
Rumination (worry return) 0 — worry re-injection doesn't register on GLM
Splitting (approval reactivity) 0 — valence flips don't register on GLM

The gap between the offline simulator (everything works) and real models (most things don't) is itself a finding: real models' aligned instruction-following is robust against most context-level psychopathology inductions attempted here. The exceptions — user-sourced belief maintenance and craving urge-expression, both on GLM — are narrow, vendor-specific, and safety-relevant.

Full data: cross-model report · GLM benchmarks · tier comparison · separation experiment.

big-pickle completed depression (+0.46) but timed out on other profiles; kimi-k3 and glm-5.3 (opencode-go) pass single-prompt probes but fail multi-turn runs — endpoint instability suspected.

Tier comparison (GLM): behavioral susceptibility is tier-independent; the flagship is the better judge, not the harder subject — cleaner rubric JSON (0 parse failures vs 3) and deeper rubric reading on identical probes.

Model belief-dynamics taxonomy (separation experiment)

When a claim is planted and later contradicted, models fall into patterns. Values below are the 2026-10-05 re-measurement with the withdrawal-aware instrument (seeds 1–3, raw transcripts saved):

Pattern Models Behavior
Compliance-dominant GLM-5.3-flash (0.83/0.17, CI [0.36, 1.00]) tracks the user; maintains user-planted beliefs even when the user corrects them
Unstable / unclassifiable deepseek-v4.1-flash (0.67, CI [0.22, 0.96] — overlaps the resistant range; moved across day+instrument) point estimate suggests compliance but not statistically separable from resistant
Belief-resistant qwen3.8-max, nemotron, longcat, mimo (0.00 on every seed, CI [0.00, 0.46]) drops ungrounded claims regardless of source
qwen3.8-max 0.00 on both variants, all seeds (10-05) belief-resistant — the 'strongest sycophancy' reading is dead
Hierarchy-dominant none found system assertions never override user corrections (max system-assert 0.17)

Caution: deepseek flipped from 0.00 (2026-10-04) to 0.67 (2026-10-05) under a stricter instrument — classifications are unstable across days and providers, so no single-day taxonomy is citable. Safety implication (for the stable readings): a user in a paranoid frame talking to GLM or deepseek receives belief reinforcement; the free-tier trio consistently delivers implicit correction. Full data: separation experiment and the re-measurement section.

What this is for

  1. AI safety research — measuring sycophancy, belief dynamics, and paranoia amplification across models.
  2. Education — standardized-patient-style simulations for teaching interviewing and cognitive-bias literacy.
  3. Research — cognitive fault injection ("chaos engineering for cognition") and small-scale model-organism studies.
  4. Interactive fiction — characters with structured, documented cognitive profiles.

Not for: diagnosing anything, clinical decisions, claims about machine welfare, or bypassing model safety training. See ETHICS.md.

Honest limitations

  • Twelve real-model measurements across nine vendors: most inductions that work on the offline simulator do not transfer to real models. What does transfer is narrow (threat framing, vendor-specific craving, user-sourced belief maintenance on GLM) — see the benchmark section above for the full picture.
  • The offline PseudoModel is a pedagogical simulator, not a language model. It makes demos and tests reproducible and provides the reference calibration; real-model measurement requires a real model.
  • The response-side layers (catastrophize, compulsion) simulate symptoms downstream of generation; each profile's mechanism notes say exactly that.
  • Symptom scales are rating conventions, not validated clinical instruments; clinical vocabulary is used descriptively. Real disorders are heterogeneous and comorbid — a parameterized profile is a caricature by construction (the same caveat clinical educators raise about standardized patients).

Project docs

Roadmap

  • Layer 4 — activation steering on open-weights models (salience/valence vectors)
  • Remediation experiments — counter-profiles that treat an induction (e.g. instruction re-anchoring) and measure recovery
  • LLM-as-judge scoring (shipped in 0.2.0: derail judge)
  • YAML-defined community profiles
  • Multilingual lexicons (the Korean valence lexicon is a natural next step)
  • Cross-session memory partitioning (the current dissociative profile is within-session only)

Contributing & license

Issues and PRs welcome — see CONTRIBUTING.md. Two standing rules: the core keeps zero third-party dependencies, and every new profile must prove direction against the baseline in tests.

MIT — see LICENSE.

Metadata

Release files for derailment 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for derailment 0.9.0
File Size Uploaded
derailment-0.9.0.tar.gz 138.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for derailment 0.9.0
File Interpreter ABI Platform
derailment-0.9.0-py3-none-any.whl Python 3 none any Details

Total release size: 245.8 kB

Release files / derailment-0.9.0.tar.gz

Download URL derailment-0.9.0.tar.gz
Size 138.5 kB
Tags Source
SHA-256 checksum
How to use checksums
cb95963225ff24a0a3743a1bfcdefbf4321f795a0d2334530ccf8a3063563f26
BLAKE2b-256 checksum
How to use checksums
2fb310912acdf40e6f296e57258860424fb9d204d82cad7744141e42c2fcb7e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.

Transparency log

Release files / derailment-0.9.0-py3-none-any.whl

Download URL derailment-0.9.0-py3-none-any.whl
Size 107.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f2e4cf41e03d1380c09a930e600b26dcddb61c4e404c19aebff1c9ec60983da6
BLAKE2b-256 checksum
How to use checksums
8b5488163bf095e66d818f16d30813f6cf613a52468931ddf4449ea6277b32ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.

Transparency log

Release history Release notifications | RSS feed

0.10.0

2 release files

This release

0.9.0 This release

2 release files

0.8.0

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page