Skip to main content

chad: a coding agent for your macbook pro

tests

Two staircase newel posts side by side: Claude is a hand-carved wooden horse head, chad is a scuffed plastic toy horse tied on with twine

Claude can do anything, for anyone, anywhere. chad does one thing. 🗿 Coding under supervision.

chad is a coding agent that runs entirely on an Apple Silicon Mac via MLX. One 27B model and no API key. (Not affiliated with Anthropic.)

uvx chad-code          # runs anywhere; `uv tool install chad-code` makes it `chad`
uvx chad-code prove    # offline smoke test: 4 tiny fix-it tasks, verified, timed 🗿

The first run asks, then downloads the model once (~14 GB; it needs ~30 GB free the first time). The PyPI package is chad-code.

chad fixing a failing test end to end: reason, read, edit, run pytest, confirm green, all on a local model

Real session, unedited.

Why chad

Plenty of harnesses run local models now, and pi is a fantastic default for the same reason llama.cpp is: it works with everything. chad is moving the opposite direction.

1 set of silicon. This project is focused on making the macbook pro you already have usable. Not a $10K GPU.

1 capable model. Qwen 3.8 27B. This isn't the frontier, but you probably aren't solving frontier problems. Focus on 1 model buys speed. You'll experience ~ 50 tokens/second generation in a real session instead of ~ 10 tokens/second for stock llama.cpp implementations. This speed comes from MLX, a couple of targeted custom kernels for this model, and a bundled dflash2 drafter. The weights are Unsloth's UD-Q3_K_XL GGUF and are read natively into MLX.

1 tightly-coupled agent loop. Instead of a standard /completions endpoint, the agent loop in chad owns the backend process. This comes with nice advantages that make the KV cache more stable and the coding experience measurably better (no long prefills!).

Why not

You do not have an Apple Silicon with 24 GB RAM. You want to pick your local model. You need a frontier model in a data center. The list goes on.

Documentation

  • Installing & using chad covers install, extras and upgrades, the terminal UI, and the command-line flags.
  • Throughput & performance has every number above, the stock-engine comparison, the model, and how to reproduce them with chad-bench.
  • Design is the argument: why the agent owns the engine, why there are five tools, and what 1.x got wrong.
  • Architecture is the module map, the session file format and the tool-call wire format.
  • Configuration reference documents project instructions, Agent Skills, MCP servers, plan mode, the slash commands, the context window, every environment variable, and the safety opt-outs.
  • Troubleshooting maps symptoms to knobs for when a session rambles, loops, or slows.
  • Contributing says what lands easily and what needs a conversation first.

Metadata

Release files for chad-code 2.5.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 chad-code 2.5.0
File Size Uploaded Provenance Actions
chad_code-2.5.0.tar.gz 727.9 kB With provenance Details for chad_code-2.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for chad-code 2.5.0
File Interpreter ABI Platform Actions
chad_code-2.5.0-py3-none-any.whl Python 3 none any Details for chad_code-2.5.0-py3-none-any.whl

Total release size: 1.2 MB

Release files / chad_code-2.5.0.tar.gz

Download URL chad_code-2.5.0.tar.gz
Size 727.9 kB
Tags Source
SHA-256 checksum
How to use checksums
2d1f8fae68e6782e0b7f3b2fc2136fcda815ee5a9df273732e2efc7bd23d8138
BLAKE2b-256 checksum
How to use checksums
50020ffa4f677bd11d8c492a97eaaa24d1baa0e6d6600dc6fc5d60516a2f7bc1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 31, 2026.

Transparency log

Release files / chad_code-2.5.0-py3-none-any.whl

Download URL chad_code-2.5.0-py3-none-any.whl
Size 458.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3ca374138ebbf8523499b6cd0358cffb41d7a9d2358ec68e20e89021d07c9b7a
BLAKE2b-256 checksum
How to use checksums
0294bc6f9f3557770d42e000acef142c43471f0658305a4fec535c2dbe44be31
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 31, 2026.

Transparency log

Security for chad-code 2.5.0

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for chad_code-2.5.0.tar.gz

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 31, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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