hanzo-node

A Python installer that downloads a hanzo-node binary from hanzoai/node release assets.

Read this first

Two different things are called hanzo-node, and this package is not the one most people want.

The hanzo-node command is a second name for the Hanzo CLI — a symlink to the same binary, which the Hanzo Cloud control binary resolves first when it delegates a verb it does not serve itself. You get it from the CLI installer, and because it is a symlink it can never drift out of step with hanzo:

curl -fsSL https://hanzo.sh | sh
hanzo-node --version     # same build as `hanzo --version`

This package installs a separate Rust agent-node binary from the hanzoai/node repository. That repository is private, so its release assets return 404 to an unauthenticated download and hanzo-node install cannot complete unless you already have access. Nothing here is being removed, but if you landed on it looking for the hanzo-node command, use the installer above.

Usage

pip install hanzo-node        # or: uv tool install hanzo-node

hanzo-node install            # fetch the binary for your platform
hanzo-node status
hanzo-node upgrade
hanzo-node run --help         # pass through to the binary
hanzo-node uninstall

It detects your platform (macOS/Linux/Windows, x64/arm64), downloads the matching asset, and installs it to ~/.local/bin — or %LOCALAPPDATA%\hanzo\bin on Windows. HANZO_INSTALL_DIR overrides the destination.

License

Apache 2.0