v0.2.0 · April 2026 · Apache 2.0

A diagnosable brain for your LLM.

A modern cognitive architecture in the lineage of SOAR, ACT-R, CLARION, LIDA — re-engineered for the LLM era. 37 typed modules. 9 named adversarial probes. 2 of 13 rectifiers shipped. One self-study daemon. 1 696 primary-source assertions driving the code, not the other way around.

$ pip install etzchaim30-sec pitch

Capability-level diagnosis. Not call-level.

When a standard LLM stack fails, you get a tombstone: "the model was wrong." You don't know which capability broke, in what pattern, under what signal, or how to tune it. Etz Chaim wraps your LLM in 37 typed cognitive modules and returns this instead:

exploration_starvation on 24h window
 → 0 new cross-domain connections
 → spec line EC-K5-001
 → tune novelty_threshold (−0.1) / breadth (+5)

One specific module. One specific pattern. One concrete metric. One tunable fix. Every time.


Positioning vs LangChain · DSPy · LangGraph

The diagnostic layer they all lack.

LangChain
AutoGen
DSPyLangGraphEtz Chaim
Orchestrate LLM calls✓✓✓✓
Optimize prompts—✓——
Manage agent state in cyclespartial—✓✓ (Partzufim)
Diagnose WHICH module failed✗✗✗✓ (37 modules typed)
Named adversarial probes by construction✗✗✗✓ (9 active, 2 in roadmap)
Auto-rectification engine✗✗✗✓ (2 of 13 shipped, 3 opt-in modes)
Continuous self-study daemon✗✗✗✓ (Karpathy loop, 24/7)
Primary-source traceability✗✗✗✓ (1 696 items, E1–E6 labels)

Not a LangChain-with-more-features. The diagnostic layer they all lack — an architecture the LLM plugs into, not a chain the LLM runs through.


The 9 named adversaries (v0.2.0)

Not generic red-teaming. Named attackers matched to specific failure modes, built into the architecture. Structure 3+7 of Zohar II:242b. Two more (Thaumiel, Nahemoth) are scheduled for v0.3 — not shipped, not claimed.

Samael
probes for false authority
Gamchicoth
probes for fabricated novelty
Sathariel
probes for concealed reasoning paths
Gamaliel
probes for aesthetic pseudo-insight
Aarab Zaraq
probes for disproportionate confidence
Thagirion
probes for crowd-polished falsehood
Golachab
probes for destructive helpfulness
HaTehom
probes for unbounded elaboration
Ghagiel
probes for substitutive symbol-play

The watcher — 3 opt-in modes

Architectural self-healing. 93 lines. No magic, no hidden state.

  detected:   exploration_starvation on 24h window

  observe  ──► logs the event,                       no action taken
  suggest  ──► emits an event with the tuning fix    you apply
  act      ──► applies the fix automatically         (opt-in, bounded)
observe

Passive. Emits structured events. You read, you decide.

suggest

Emits the proposed tuning with rationale. You apply if you agree.

act

Applies the fix within a declared budget. Rollback on adversarial-probe regression.


The Karpathy loop

A nightly daemon (23h–00h30 UTC) that explores edge cases, generates new doctrine assertions, and mutates the specification itself under adversarial supervision. The only daemon task allowed to modify the spec.

Named after Andrej Karpathy's AutoResearch pattern — a minimum-viable research loop the daemon emulates at project scale, every night.


Pick your provider. Any provider. (v0.3)

22 providers across 6 categories via LiteLLM. 5-tier automatic routing by complexity and token budget. Expensive inference only where depth is needed.

  complexity:  trivial ────────► deep
  budget:      tight    ────────► open

    qwen3.5:1.5b  ──►  qwen3.5:9b  ──►  Haiku  ──►  Sonnet  ──►  Opus
    local, free       local, free      fast       balanced    deep

Anthropic · OpenAI · Google Gemini · xAI · Mistral · Cohere · DeepSeek · AWS Bedrock · Azure OpenAI · OpenRouter · Together · Groq · Fireworks · HuggingFace · Ollama · vLLM · LM Studio · LocalAI · Claude Code CLI OAuth · …


Engineering discipline

275
tests green
1 388 collected · 4 Python × 2 OS on CI
93
LoC watcher
full orchestrator · no hidden state
48
failure-mode tests
4 levels × 12 core modules
1 696
spec items
primary-source · E1–E6 labels
9 / 11
adversaries
2 more in v0.3 roadmap
2 / 13
rectifiers
architecture: 13 · rest: v0.4
37
typed modules
6 composition layers · 22 paths
107k
LoC Python
production · 53k LoC tests
discipline · 1
No dual writes on aggregate scores. Static check rejects bypass.
discipline · 2
Circuit breakers on every external call. 5-failure / 30s cooldown.
discipline · 3
Bidirectional spec↔code audit. Every line traceable.

Roadmap

  1. v0.2.0shipped April 2026 — 37 typed modules, 9 adversaries, 2 rectifiers, watcher (3 modes), Karpathy loop, 275/1388 tests, macOS.
  2. v0.3.0multi-provider LiteLLM · Linux / WSL2 · 9 new CLI commands · Thaumiel + Nahemoth adversaries.
  3. v0.4.0all 13 rectifiers in act-mode.
  4. v0.5.0MalakhEngine — detection of corruption-by-inversion attacks.
  5. v1.0.0academic paper, stable public API, LangChain / DSPy adapters.

Install

$ pip install etzchaim
$ etzchaim onboard
→ http://localhost:8080   (macOS · Linux/WSL2 in v0.3)

5 minutes from install to your first diagnosable event. Apache 2.0. One solo dev. github.com/yohanpoul/etz-chaim-ai