Files
python-sdk/pkg/hanzo-node
zeekay 6ef7d37462 feat: add hanzo-node cross-platform binary installer
Python package that downloads and installs the Rust hanzo-node binary
for the current platform (macOS/Linux/Windows, x64/arm64).

- Detects platform and downloads appropriate binary from GitHub releases
- Installs to ~/.local/bin (or %LOCALAPPDATA%\hanzo\bin on Windows)
- CLI commands: install, uninstall, upgrade, status, run
- Passes through to actual binary when installed
2026-01-21 20:37:15 -08:00
..

hanzo-node

Cross-platform installer for the Hanzo AI node (Rust binary).

Installation

# Install via uv
uv tool install hanzo-node

# Or via pip
pip install hanzo-node

Usage

# Install the node binary
hanzo-node install

# Check status
hanzo-node status

# Upgrade to latest
hanzo-node upgrade

# Run the node (passes args to binary)
hanzo-node run --help

# Uninstall
hanzo-node uninstall

How It Works

This Python package is a thin wrapper that:

  1. Detects your platform (macOS/Linux/Windows, x64/arm64)
  2. Downloads the appropriate Rust binary from GitHub releases
  3. Installs it to ~/.local/bin (or %LOCALAPPDATA%\hanzo\bin on Windows)
  4. Provides a CLI to manage the installation

The actual hanzo-node is written in Rust for performance. This package just handles cross-platform distribution.

Supported Platforms

  • macOS (Apple Silicon / Intel)
  • Linux (x64 / arm64)
  • Windows (x64)

Environment Variables

  • HANZO_INSTALL_DIR - Override the installation directory (default: ~/.local/bin)

License

Apache 2.0