chad-code 0.1.0__tar.gz → 1.0.0__tar.gz

chad_code-1.0.0/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: chad-code
+Version: 1.0.0
+Summary: Local MLX-backed, Claude-Code-style coding agent (Apple Silicon, Ornith 35B/9B)
+License-Expression: MIT
+Project-URL: Repository, https://github.com/nathansutton/chad
+Project-URL: Issues, https://github.com/nathansutton/chad/issues
+Keywords: mlx,coding-agent,apple-silicon,local-llm,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mlx<0.33,>=0.32.0; sys_platform == "darwin"
+Requires-Dist: mlx-lm<0.32,>=0.31.3; sys_platform == "darwin"
+Requires-Dist: transformers<5.13,>=5.0
+Requires-Dist: jinja2>=3.1
+Requires-Dist: numpy<2,>=1.26
+Requires-Dist: huggingface-hub>=1.22.0
+Requires-Dist: jedi>=0.19.2
+Requires-Dist: prompt_toolkit>=3.0.43
+Requires-Dist: tree-sitter>=0.26.0
+Requires-Dist: tree-sitter-language-pack>=1.12.2
+Requires-Dist: rustworkx>=0.15
+Requires-Dist: mcp>=1.27
+Provides-Extra: highlight
+Requires-Dist: pygments>=2.17; extra == "highlight"
+Provides-Extra: lsp
+Requires-Dist: serena-agent>=1.5; extra == "lsp"
+Dynamic: license-file
+
+# chad — a local, MLX-backed coding agent
+
+[![tests](https://github.com/nathansutton/chad/actions/workflows/tests.yml/badge.svg)](https://github.com/nathansutton/chad/actions/workflows/tests.yml)
+
+<img src="docs/tbench-size-vs-score.png" width="840" alt="Terminal-Bench 2.0: accuracy vs. model size. chad + Ornith (a 35B MoE) lands on the Claude Sonnet 4.5 line, matching open models many times its size and standing alone in the laptop-class ≤40B band.">
+
+> Claude can do anything, for anyone, anywhere. chad does one thing. 🗿
+> *Coding under supervision.*
+
+A single-user coding agent that runs **entirely locally on Apple Silicon** via
+[MLX](https://github.com/ml-explore/mlx). Claude-Code-style tool use (bash, read, write,
+edit, glob, grep), plan mode, and a full-screen TUI — driven by a local model on your
+laptop instead of a frontier model in a datacenter. No Docker, no API key, no model picker.
+
+## Quickstart
+
+Apple Silicon Mac + [uv](https://docs.astral.sh/uv/). One command — no clone, no config:
+
+```bash
+uvx chad-code          # runs chad anywhere — the command is still `chad`
+uvx chad-code prove    # 2-min offline smoke test: 4 tiny fix-it tasks, verified, timed 🗿
+```
+
+First run picks the right Ornith model for your RAM (9B under 32 GB, 35B at 32 GB+), asks,
+and downloads it once (~5 GB / ~13 GB, resumable) into the shared Hugging Face cache. While
+it downloads, `cd` into a project and think of a scoped first ask — *"fix the failing test
+in `tests/test_x.py`"* lands; *"improve my codebase"* flails.
+
+> The PyPI package is **`chad-code`**; bare `chad` is an unrelated squatted package. Other
+> ways in (PATH install, bleeding-edge `main`, dev clone) are in
+> [Installing & upgrading](#installing--upgrading).
+
+## chad is not a baby Claude
+
+He has some of the same moves — tool use, plan mode, a real TUI — but he's a blunter
+instrument:
+
+|                 | **Claude**                                      | **chad** 🗿                     |
+|-----------------|-------------------------------------------------|---------------------------------|
+| **Range**       | every workflow, every person, incredible nuance | one job: code, on your machine  |
+| **Runs**        | anywhere — cloud, IDE, terminal, phone          | your mac. that's it.            |
+| **Brain**       | a frontier model in a datacenter                | Ornith model                    |
+| **Disposition** | understands what you *meant*                    | does what you *said*            |
+| **Harness**     | open-ended, anything you can imagine            | plan. execute. nothing else.    |
+| **When wrong**  | reasons a way out                               | already shipped                 |
+
+![chad fixing a failing test end to end — reason, read, edit, rerun pytest, all on a local 35B](docs/demo.gif)
+
+> Real session, unedited (cold model load cut): a local 35B reasons through the failure,
+> edits the file, reruns the tests, confirms green.
+
+## Sonnet on your laptop
+
+The exam is [Terminal-Bench](https://www.tbench.ai/leaderboard), the standard benchmark for
+CLI coding agents. chad won't top it — the A students are frontier models in datacenters.
+The number worth looking at is **how much capability chad wrings out of 35B parameters**:
+on Terminal-Bench 2.1, chad + Ornith lands around the **Claude Sonnet 4.5** line, matching
+open models many times its size and beating every open model in its own weight class by a
+wide margin. On a laptop, *capability per parameter* is the axis you actually compete on —
+and that's where chad + Ornith is out on the frontier alone.
+
+> **Placeholder number** — the full verified run is still in flight (`≈50%`, k=1). The whole
+> benchmark is **publicly reproducible from a Mac**: the exact Harbor adapter, the runner,
+> and the recipe live in [`benchmarks/tb2/`](benchmarks/tb2/README.md). Check it, don't
+> trust it.
+
+## The bet: at this end of the report card, the harness beats the model
+
+Every serious coding harness was built for a frontier model behind a datacenter API — which
+bakes in two assumptions that are both false on a laptop: the model is an A student, and
+prefill is somebody else's electricity. A C+ student emits tool calls with typos, quotes
+edits it never applies, and rambles — and every token of transcript it drags around must be
+re-read by *your* GPU at a few hundred tokens a second.
+
+So chad's thesis isn't "run a model locally" — plenty of tools do that. It's that **for a
+small model, harness quality is worth more than a model upgrade**, and the harness and
+inference engine have to be designed *together*. The failure modes are all nameable: the
+model pours its edit into the reasoning channel and the harness drops it; asks for a tool
+the harness doesn't ship; balloons the context until cache reuse hits 0% and decode falls to
+2 tok/s. chad handles each *inside* the harness — tool calls parsed in four dialects and
+repaired, arguments schema-coerced with a self-repair loop, edits run through a forgiveness
+cascade, and above all the transcript kept a **strict token-prefix of the live KV cache** so
+prefill never re-reads what it already read. That co-design is the whole moat. The full
+story is in [Design & internals](docs/design.md).
+
+## Installing & upgrading
+
+The one-line quickstart (`uvx chad-code`) is up top. The other ways in:
+
+```bash
+uv tool install chad-code   # install for good — then it's just `chad`
+uvx --from git+https://github.com/nathansutton/chad chad   # bleeding-edge main, no clone
+```
+
+Or from a clone (the dev path):
+
+```bash
+uv sync                      # install deps + the `chad` entrypoint (one time)
+uv run chad                  # full-screen TUI
+uv run chad "add a --json flag to main.py and update the tests"   # one-shot, headless
+uv run chad -c               # resume this directory's last conversation
+```
+
+**The model.** chad picks one for you by RAM and downloads it once into the shared Hugging
+Face cache (`~/.cache/huggingface`, reused across every project). No picker, no flags —
+override with `CHAD_MODEL=<repo or local dir>` if you must.
+
+| Your Mac | Model | Footprint |
+|---|---|---|
+| **≥ 32 GB** | [Ornith-1.0-35B `UD-Q2_K_XL`](https://huggingface.co/nathansutton/Ornith-1.0-35B-UD-Q2_K_XL-MLX) — 35B MoE, 2-bit experts | ~13 GB resident (~16 GB with KV) |
+| **16 / 18 / 24 GB** | [Ornith-1.0-9B `UD-Q4_K_XL`](https://huggingface.co/nathansutton/Ornith-1.0-9B-UD-Q4_K_XL-MLX) — 4-bit AWQ | ~5 GB |
+
+The 35B's working set needs headroom a 24 GB Mac doesn't have (it SIGKILLs mid-turn), so its
+floor is **32 GB**; 24 GB and below run the 9B. Quant names follow
+[Unsloth's dynamic-quant convention](https://docs.unsloth.ai/) (`UD-…`).
+
+**Upgrading** — depends on how you installed: `uv tool upgrade chad-code`; `uvx --refresh
+chad-code`; or `git pull && uv sync` for a clone. What changed lands in
+[`CHANGELOG.md`](CHANGELOG.md). Model weights are versioned separately — a code upgrade never
+re-downloads the model.
+
+**Development.** `uv sync` once, then `uv run pytest -q` — the fast unit gate loads **no
+model weights**, runs in seconds, and is what CI runs. Throughput on your own machine:
+`uv run chad-bench` (see [Throughput & performance](docs/benchmarks.md)). LSP-precise
+find-references / rename need the `lsp` extra (`uv tool install 'chad-code[lsp]'`); without
+it chad uses the tree-sitter fallback automatically.
+
+## Interactive UX
+
+`uv run chad` launches a full-screen terminal UI (built on prompt_toolkit):
+
+- **shift-tab cycles permission modes** — `normal` (confirm each bash/write/edit) →
+  `auto-accept edits` → `plan mode` (read-only: investigate + propose a numbered plan) → back.
+- **type-ahead message queue** — keep typing while the agent works; messages run in order.
+- **ctrl-c interrupts the running turn** without killing the session.
+- **live status line** — model, mode, context %, a state glyph + verb, elapsed seconds, and
+  **↑prefilled / ↓generated** token counts (with an advancing **%** on an unavoidable full
+  re-prefill, so it's never silent).
+- **slash commands** — `/init`, `/skills`, `/mcp`, `/accept`, `/resume`, `/compact`,
+  `/model`, `/mode`, `/help`, `/exit`. Same set in the `--repl` line interface.
+- **`@file` / `@dir` mentions** and **`!command` shell passthrough** — pull a file into
+  context inline, or run a shell command without invoking the model.
+
+**Usage.** `uv run chad --help` is the source of truth:
+
+| Flag | What it does |
+|---|---|
+| `-c, --continue` | resume this directory's **most recent** session (non-destructive) |
+| `--resume` | list recent sessions, pick one by number (interactive TTY only) |
+| `--plan` | start in read-only plan mode (investigate + propose, edits blocked) |
+| `--yolo` | auto-approve bash/write/edit (skip confirm prompts) |
+| `--no-think` | skip Ornith's `<think>` blocks — faster on well-scoped work |
+| `--repl` | plain line REPL instead of the TUI |
+
+A headless task (positional, or piped with no TTY) auto-approves mutating tools; the model
+runs greedy (temp 0). Every conversation is persisted under `~/.chad/sessions/`, and every
+resume forks a new branch rather than overwriting — details in
+[Configuration](docs/configuration.md#sessions). The rarely-touched tuning knobs
+(`CHAD_MAX_CONTEXT`, `CHAD_KV_BITS`, turn-budget/think-cap, safety opt-outs) all live in
+environment variables, fully documented there.
+
+## Extending chad
+
+chad speaks the same two extension formats as Claude Code:
+
+- **[Agent Skills](https://agentskills.io)** — drop a `SKILL.md` folder in `./.claude/skills/`
+  and chad discovers it, loading the full instructions only when a task matches.
+- **[MCP servers](https://modelcontextprotocol.io)** — configure stdio or HTTP servers in
+  `./.mcp.json` to expose external tools (GitHub, Postgres, Linear, Slack, …) alongside
+  chad's builtins, with static-token and OAuth auth.
+
+Both are covered in full in the [Configuration reference](docs/configuration.md).
+
+## Documentation
+
+- **[Design & internals](docs/design.md)** — why prefill is the bill, the persistent prefix
+  cache, the trimmable/append-only trade, and the ideas borrowed from other agents.
+- **[Throughput & performance](docs/benchmarks.md)** — prefill / decode / warm-step numbers
+  you can reproduce with `chad-bench`.
+- **[Terminal-Bench 2.0 reproduction](benchmarks/tb2/README.md)** — the exact Harbor adapter
+  and runner behind the chart; serve Ornith yourself and check the number.
+- **[Configuration reference](docs/configuration.md)** — Agent Skills, MCP servers, the
+  context window, every environment variable, and the safety opt-outs.
+- **[Troubleshooting](docs/troubleshooting.md)** — when a session rambles, loops, or slows:
+  the symptom→knob map for a small local model.
+- **[Contributing](CONTRIBUTING.md)** — what lands easily, and what needs a conversation first.

chad_code-1.0.0/README.md

@@ -0,0 +1,186 @@
+# chad — a local, MLX-backed coding agent
+
+[![tests](https://github.com/nathansutton/chad/actions/workflows/tests.yml/badge.svg)](https://github.com/nathansutton/chad/actions/workflows/tests.yml)
+
+<img src="docs/tbench-size-vs-score.png" width="840" alt="Terminal-Bench 2.0: accuracy vs. model size. chad + Ornith (a 35B MoE) lands on the Claude Sonnet 4.5 line, matching open models many times its size and standing alone in the laptop-class ≤40B band.">
+
+> Claude can do anything, for anyone, anywhere. chad does one thing. 🗿
+> *Coding under supervision.*
+
+A single-user coding agent that runs **entirely locally on Apple Silicon** via
+[MLX](https://github.com/ml-explore/mlx). Claude-Code-style tool use (bash, read, write,
+edit, glob, grep), plan mode, and a full-screen TUI — driven by a local model on your
+laptop instead of a frontier model in a datacenter. No Docker, no API key, no model picker.
+
+## Quickstart
+
+Apple Silicon Mac + [uv](https://docs.astral.sh/uv/). One command — no clone, no config:
+
+```bash
+uvx chad-code          # runs chad anywhere — the command is still `chad`
+uvx chad-code prove    # 2-min offline smoke test: 4 tiny fix-it tasks, verified, timed 🗿
+```
+
+First run picks the right Ornith model for your RAM (9B under 32 GB, 35B at 32 GB+), asks,
+and downloads it once (~5 GB / ~13 GB, resumable) into the shared Hugging Face cache. While
+it downloads, `cd` into a project and think of a scoped first ask — *"fix the failing test
+in `tests/test_x.py`"* lands; *"improve my codebase"* flails.
+
+> The PyPI package is **`chad-code`**; bare `chad` is an unrelated squatted package. Other
+> ways in (PATH install, bleeding-edge `main`, dev clone) are in
+> [Installing & upgrading](#installing--upgrading).
+
+## chad is not a baby Claude
+
+He has some of the same moves — tool use, plan mode, a real TUI — but he's a blunter
+instrument:
+
+|                 | **Claude**                                      | **chad** 🗿                     |
+|-----------------|-------------------------------------------------|---------------------------------|
+| **Range**       | every workflow, every person, incredible nuance | one job: code, on your machine  |
+| **Runs**        | anywhere — cloud, IDE, terminal, phone          | your mac. that's it.            |
+| **Brain**       | a frontier model in a datacenter                | Ornith model                    |
+| **Disposition** | understands what you *meant*                    | does what you *said*            |
+| **Harness**     | open-ended, anything you can imagine            | plan. execute. nothing else.    |
+| **When wrong**  | reasons a way out                               | already shipped                 |
+
+![chad fixing a failing test end to end — reason, read, edit, rerun pytest, all on a local 35B](docs/demo.gif)
+
+> Real session, unedited (cold model load cut): a local 35B reasons through the failure,
+> edits the file, reruns the tests, confirms green.
+
+## Sonnet on your laptop
+
+The exam is [Terminal-Bench](https://www.tbench.ai/leaderboard), the standard benchmark for
+CLI coding agents. chad won't top it — the A students are frontier models in datacenters.
+The number worth looking at is **how much capability chad wrings out of 35B parameters**:
+on Terminal-Bench 2.1, chad + Ornith lands around the **Claude Sonnet 4.5** line, matching
+open models many times its size and beating every open model in its own weight class by a
+wide margin. On a laptop, *capability per parameter* is the axis you actually compete on —
+and that's where chad + Ornith is out on the frontier alone.
+
+> **Placeholder number** — the full verified run is still in flight (`≈50%`, k=1). The whole
+> benchmark is **publicly reproducible from a Mac**: the exact Harbor adapter, the runner,
+> and the recipe live in [`benchmarks/tb2/`](benchmarks/tb2/README.md). Check it, don't
+> trust it.
+
+## The bet: at this end of the report card, the harness beats the model
+
+Every serious coding harness was built for a frontier model behind a datacenter API — which
+bakes in two assumptions that are both false on a laptop: the model is an A student, and
+prefill is somebody else's electricity. A C+ student emits tool calls with typos, quotes
+edits it never applies, and rambles — and every token of transcript it drags around must be
+re-read by *your* GPU at a few hundred tokens a second.
+
+So chad's thesis isn't "run a model locally" — plenty of tools do that. It's that **for a
+small model, harness quality is worth more than a model upgrade**, and the harness and
+inference engine have to be designed *together*. The failure modes are all nameable: the
+model pours its edit into the reasoning channel and the harness drops it; asks for a tool
+the harness doesn't ship; balloons the context until cache reuse hits 0% and decode falls to
+2 tok/s. chad handles each *inside* the harness — tool calls parsed in four dialects and
+repaired, arguments schema-coerced with a self-repair loop, edits run through a forgiveness
+cascade, and above all the transcript kept a **strict token-prefix of the live KV cache** so
+prefill never re-reads what it already read. That co-design is the whole moat. The full
+story is in [Design & internals](docs/design.md).
+
+## Installing & upgrading
+
+The one-line quickstart (`uvx chad-code`) is up top. The other ways in:
+
+```bash
+uv tool install chad-code   # install for good — then it's just `chad`
+uvx --from git+https://github.com/nathansutton/chad chad   # bleeding-edge main, no clone
+```
+
+Or from a clone (the dev path):
+
+```bash
+uv sync                      # install deps + the `chad` entrypoint (one time)
+uv run chad                  # full-screen TUI
+uv run chad "add a --json flag to main.py and update the tests"   # one-shot, headless
+uv run chad -c               # resume this directory's last conversation
+```
+
+**The model.** chad picks one for you by RAM and downloads it once into the shared Hugging
+Face cache (`~/.cache/huggingface`, reused across every project). No picker, no flags —
+override with `CHAD_MODEL=<repo or local dir>` if you must.
+
+| Your Mac | Model | Footprint |
+|---|---|---|
+| **≥ 32 GB** | [Ornith-1.0-35B `UD-Q2_K_XL`](https://huggingface.co/nathansutton/Ornith-1.0-35B-UD-Q2_K_XL-MLX) — 35B MoE, 2-bit experts | ~13 GB resident (~16 GB with KV) |
+| **16 / 18 / 24 GB** | [Ornith-1.0-9B `UD-Q4_K_XL`](https://huggingface.co/nathansutton/Ornith-1.0-9B-UD-Q4_K_XL-MLX) — 4-bit AWQ | ~5 GB |
+
+The 35B's working set needs headroom a 24 GB Mac doesn't have (it SIGKILLs mid-turn), so its
+floor is **32 GB**; 24 GB and below run the 9B. Quant names follow
+[Unsloth's dynamic-quant convention](https://docs.unsloth.ai/) (`UD-…`).
+
+**Upgrading** — depends on how you installed: `uv tool upgrade chad-code`; `uvx --refresh
+chad-code`; or `git pull && uv sync` for a clone. What changed lands in
+[`CHANGELOG.md`](CHANGELOG.md). Model weights are versioned separately — a code upgrade never
+re-downloads the model.
+
+**Development.** `uv sync` once, then `uv run pytest -q` — the fast unit gate loads **no
+model weights**, runs in seconds, and is what CI runs. Throughput on your own machine:
+`uv run chad-bench` (see [Throughput & performance](docs/benchmarks.md)). LSP-precise
+find-references / rename need the `lsp` extra (`uv tool install 'chad-code[lsp]'`); without
+it chad uses the tree-sitter fallback automatically.
+
+## Interactive UX
+
+`uv run chad` launches a full-screen terminal UI (built on prompt_toolkit):
+
+- **shift-tab cycles permission modes** — `normal` (confirm each bash/write/edit) →
+  `auto-accept edits` → `plan mode` (read-only: investigate + propose a numbered plan) → back.
+- **type-ahead message queue** — keep typing while the agent works; messages run in order.
+- **ctrl-c interrupts the running turn** without killing the session.
+- **live status line** — model, mode, context %, a state glyph + verb, elapsed seconds, and
+  **↑prefilled / ↓generated** token counts (with an advancing **%** on an unavoidable full
+  re-prefill, so it's never silent).
+- **slash commands** — `/init`, `/skills`, `/mcp`, `/accept`, `/resume`, `/compact`,
+  `/model`, `/mode`, `/help`, `/exit`. Same set in the `--repl` line interface.
+- **`@file` / `@dir` mentions** and **`!command` shell passthrough** — pull a file into
+  context inline, or run a shell command without invoking the model.
+
+**Usage.** `uv run chad --help` is the source of truth:
+
+| Flag | What it does |
+|---|---|
+| `-c, --continue` | resume this directory's **most recent** session (non-destructive) |
+| `--resume` | list recent sessions, pick one by number (interactive TTY only) |
+| `--plan` | start in read-only plan mode (investigate + propose, edits blocked) |
+| `--yolo` | auto-approve bash/write/edit (skip confirm prompts) |
+| `--no-think` | skip Ornith's `<think>` blocks — faster on well-scoped work |
+| `--repl` | plain line REPL instead of the TUI |
+
+A headless task (positional, or piped with no TTY) auto-approves mutating tools; the model
+runs greedy (temp 0). Every conversation is persisted under `~/.chad/sessions/`, and every
+resume forks a new branch rather than overwriting — details in
+[Configuration](docs/configuration.md#sessions). The rarely-touched tuning knobs
+(`CHAD_MAX_CONTEXT`, `CHAD_KV_BITS`, turn-budget/think-cap, safety opt-outs) all live in
+environment variables, fully documented there.
+
+## Extending chad
+
+chad speaks the same two extension formats as Claude Code:
+
+- **[Agent Skills](https://agentskills.io)** — drop a `SKILL.md` folder in `./.claude/skills/`
+  and chad discovers it, loading the full instructions only when a task matches.
+- **[MCP servers](https://modelcontextprotocol.io)** — configure stdio or HTTP servers in
+  `./.mcp.json` to expose external tools (GitHub, Postgres, Linear, Slack, …) alongside
+  chad's builtins, with static-token and OAuth auth.
+
+Both are covered in full in the [Configuration reference](docs/configuration.md).
+
+## Documentation
+
+- **[Design & internals](docs/design.md)** — why prefill is the bill, the persistent prefix
+  cache, the trimmable/append-only trade, and the ideas borrowed from other agents.
+- **[Throughput & performance](docs/benchmarks.md)** — prefill / decode / warm-step numbers
+  you can reproduce with `chad-bench`.
+- **[Terminal-Bench 2.0 reproduction](benchmarks/tb2/README.md)** — the exact Harbor adapter
+  and runner behind the chart; serve Ornith yourself and check the number.
+- **[Configuration reference](docs/configuration.md)** — Agent Skills, MCP servers, the
+  context window, every environment variable, and the safety opt-outs.
+- **[Troubleshooting](docs/troubleshooting.md)** — when a session rambles, loops, or slows:
+  the symptom→knob map for a small local model.
+- **[Contributing](CONTRIBUTING.md)** — what lands easily, and what needs a conversation first.

{chad_code-0.1.0 → chad_code-1.0.0}/pyproject.toml

@@ -2,9 +2,9 @@
 # Distribution name is `chad-code` (bare `chad` on PyPI is a squatted 2014 package).
 # The IMPORT package (src/chad/) and the `chad` command are unchanged — dist name,
 # import name, and command name are independent. `uvx chad-code` runs the alias
-# script added under [project.scripts]. See private/plans/063.
+# script added under [project.scripts].
 name = "chad-code"
-version = "0.1.0"
+version = "1.0.0"
 description = "Local MLX-backed, Claude-Code-style coding agent (Apple Silicon, Ornith 35B/9B)"
 readme = "README.md"
 license = "MIT"
@@ -30,19 +30,31 @@ dependencies = [
     # loader (expert-weight stacking + vision-tower strip). A minor bump could refactor it
     # and silently break the `uvx --from git+…` install path, which resolves fresh from
     # PyPI and ignores uv.lock. Stay on the known-good 0.31 line; bump deliberately.
-    "mlx>=0.31.2,<0.32",
-    "mlx-lm>=0.31.3,<0.32",
+    # Apple-only: no CPU/CUDA build exists. Platform-gated so `pip install chad-code`
+    # succeeds on Linux (e.g. a benchmark container) for the remote `--backend llama`
+    # path, which loads no MLX. On macOS the default in-process engine installs it as before.
+    # mlx 0.32.0: Metal command-buffer failures (incl. OOM) become catchable Python
+    # exceptions instead of a SIGABRT (ml-explore/mlx#3523) — engine._prefill/generate
+    # lean on that for the 35B-on-24GB recovery path. Perf re-gated
+    # on the bump: prefill/decode within noise of 0.31.2 on both shipped models.
+    "mlx>=0.32.0,<0.33; sys_platform == 'darwin'",
+    "mlx-lm>=0.31.3,<0.32; sys_platform == 'darwin'",
     # mlx-lm requires transformers>=5.0, but 5.13.0 regressed AutoTokenizer.register:
     # it now does `key.__module__.startswith("transformers.")` with no hasattr guard, and
     # mlx-lm's tokenizer_utils passes the *string* "NewlineTokenizer" as config_class →
     # AttributeError at import. Cap below 5.13 until mlx-lm or transformers fixes it.
     "transformers>=5.0,<5.13",
+    # transformers needs jinja2 to render `apply_chat_template` (chad's `_render` on every
+    # backend). It's an OPTIONAL transformers dep — present transitively on a dev Mac but
+    # absent in a clean install (e.g. chad inside a Linux benchmark container), where its
+    # absence crashes the first turn. Declare it directly.
+    "jinja2>=3.1",
     "numpy>=1.26,<2",
-    "huggingface-hub>=0.34", # first-run model download (cli.py/engine.py); imported directly, not just transitively
+    "huggingface-hub>=1.22.0", # first-run model download (cli.py/engine.py); imported directly, not just transitively
     "jedi>=0.19.2", # in-process symbolic code intelligence (read/search/edit)
     "prompt_toolkit>=3.0.43",
-    "tree-sitter>=0.25.2",
-    "tree-sitter-language-pack>=1.11.0",
+    "tree-sitter>=0.26.0",
+    "tree-sitter-language-pack>=1.12.2",
     # repomap's personalized PageRank. Native and battle-tested where the previous
     # hand-rolled power iteration was ours to maintain; single self-contained Rust
     # wheel, zero transitive deps. Benchmarked vs scipy/networkx/igraph on a real
@@ -54,7 +66,7 @@ dependencies = [
     "mcp>=1.27",
 ]
 
-# Optional syntax highlighting in diffs / confirm previews (plan 042 item 4). Pure-Python,
+# Optional syntax highlighting in diffs / confirm previews. Pure-Python,
 # import-guarded in render.py: absent, output is byte-identical to the un-highlighted path.
 # Install with `uv sync --extra highlight`.
 # NOTE: no PyPI release exists; 'pip install chad' installs an unrelated squatted
@@ -86,7 +98,7 @@ Issues = "https://github.com/nathansutton/chad/issues"
 dev = ["pytest>=8", "ruff>=0.6", "mypy>=1.11", "types-pyyaml>=6"]
 
 [build-system]
-requires = ["setuptools>=61"]
+requires = ["setuptools>=83.0.0"]
 build-backend = "setuptools.build_meta"
 
 # Standard src layout: the importable package lives at src/chad/. setuptools
@@ -97,8 +109,9 @@ where = ["src"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-# The model-backed eval tiers self-skip without weights; the fast unit gate stays green.
-addopts = "-q"
+# No "-q" here: CI/docs/agents all invoke `pytest -q` explicitly, and stacking the two
+# (verbosity -2) suppresses the final "N passed" summary line entirely — an agent
+# running the gate then gets output with no verdict in it.
 
 [tool.ruff]
 line-length = 100
@@ -128,3 +141,12 @@ implicit_optional = true        # `x: T = None` defaults are idiomatic throughou
 disable_error_code = ["var-annotated"]
 # Tighten (disallow_untyped_defs, re-enable var-annotated, add B/UP/SIM in ruff) in a
 # follow-up once this baseline holds.
+
+[[tool.mypy.overrides]]
+# mlx_fastpath patches mlx_lm classes that only exist on macOS: with mlx installed
+# (dev Macs, the macos CI jobs) its `type: ignore[method-assign]` comments are load-
+# bearing; on the Linux lint runner mlx_lm is absent, the patched classes type as Any,
+# and warn_unused_ignores flags those same comments — unfixable in the code for both
+# platforms at once, so the unused-ignore warning alone is relaxed for this module.
+module = "chad.mlx_fastpath"
+warn_unused_ignores = false

{chad_code-0.1.0 → chad_code-1.0.0}/src/chad/__init__.py

@@ -4,4 +4,4 @@ A flat collection of cooperating modules behind one console script (``chad``):
 the inference engine, the tool layer, the agent loop, and the terminal UI.
 """
 
-__version__ = "0.1.0"
+__version__ = "1.0.0"