Installation

Hezo ships as a single self-contained binary - there's no runtime, language toolchain, or dependencies to install. Download it, run it, and you're up in seconds. The one thing to have in place first is Docker, which Hezo uses to run each project's agents in an isolated container.

Prerequisites

• Docker - Docker Engine (Linux) or Docker Desktop (macOS/Windows), running and reachable. Hezo launches a container per project through it. On startup Hezo checks for a working Docker daemon and, if it's missing or stopped, prints how to install or start it (with a link to Docker's install page) and exits - so install Docker first.
• A machine you're happy to leave running while agents work (a laptop is fine to start; a small always-on server is better for long-running teams).

Install the binary

The one-line installer detects your OS and CPU architecture and downloads the matching binary from the latest release.

curl -fsSL https://hezo.ai/install.sh | sh

Manual download

Prefer to grab the binary yourself? Every release is published on GitHub Releases. Download the asset for your platform, make it executable (chmod +x), and put it on your PATH.

Start the server

hezo

This boots the Hezo server on port 3100 and creates its data directory at ~/.hezo/ on first run. Open http://localhost:3100 in your browser to continue.

To run on a different port or data directory:

hezo --port 8080 --data-dir /path/to/data

See the Configuration reference for every flag and environment variable.

Verify the install

hezo --help