Hanzo

Installation

Install Hanzo Dev from npm, Homebrew, or build from source.

System Requirements

RequirementDetails
Operating systemsmacOS 12+, Ubuntu 20.04+/Debian 10+, or Windows 11 via WSL2
Git (optional, recommended)2.23+ for built-in PR helpers
RAM4 GB minimum (8 GB recommended)

Install via npm

npm install -g @hanzo/dev

Install via npx

npx @hanzo/dev

DotSlash

The GitHub Release also contains a DotSlash file for Hanzo Dev named dev. Using a DotSlash file makes it possible to make a lightweight commit to source control to ensure all contributors use the same version of the executable, regardless of platform.

Build from Source

# Clone the repository
git clone https://github.com/hanzoai/dev.git
cd dev

# Install the Rust toolchain if necessary
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"

# Build (~20 min cold, ~2 min incremental)
./build-fast.sh

# Launch the TUI
./hanzo-dev/target/dev-fast/dev

Tracing / Verbose Logging

Hanzo Dev is written in Rust and honors the RUST_LOG environment variable.

The TUI defaults to RUST_LOG=hanzo_core=info,hanzo_tui=info and writes logs to ~/.hanzo/log/codex-tui.log. Override the log directory with -c log_dir=... for a single run.

tail -F ~/.hanzo/log/codex-tui.log

Non-interactive mode (dev exec) defaults to RUST_LOG=error with inline output.

See the Rust RUST_LOG documentation for all configuration options.

How is this guide?

Last updated on

On this page