Installation

Requirements

• Apple Silicon macOS
• Apple container CLI (container)
• one inference backend:
  • llama.cpp (llama-server)
  • mlxcel (mlxcel-server)

You can validate prerequisites with:

muthr doctor

Install muthr

Homebrew

brew install tappunk/muthr/muthr

Cargo

cargo install muthr

First-time bootstrap

muthr init
muthr config init

Then inspect effective config:

muthr config show

Recommended defaults

For sandbox connectivity to host inference:

• default_engine_bind_host = "0.0.0.0"

For safer project scoping:

• workspace_root = "~/src" (never $HOME)

For turnkey profile usage:

• default_provision_profile = "opencode" or "hermes-agent"

---

See also: Configuration · Quickstart · Troubleshooting