Installation

The the0 CLI is a Go binary that can be installed with a single command or built from source.

Prerequisites

To deploy bots that use Python or Node.js dependencies, you need Docker installed and running. The CLI uses Docker to vendor dependencies in a consistent Linux environment.

Quick Install (Recommended)

Install with a single command:

curl -sSL https://install.the0.app | sh

This downloads the latest release binary, verifies its SHA256 checksum, and installs to ~/.the0/bin. The script automatically configures your PATH.

Supported platforms:

• Linux (amd64, arm64)
• macOS (amd64, arm64)

Install from Source

Building from source requires Go 1.21 or later.

# Clone the repository
git clone https://github.com/alexanderwanyoike/the0.git
cd the0/cli

# Build and install to ~/bin
make install

This compiles the CLI and copies it to ~/bin/the0. Ensure ~/bin is in your PATH:

export PATH="$HOME/bin:$PATH"

Add this line to your shell configuration file (~/.bashrc, ~/.zshrc, etc.) to make it permanent.

Updating

The CLI can update itself to the latest release:

the0 update

This checks GitHub Releases, downloads the new binary with checksum verification, and replaces the current binary.

Verify Installation

Confirm the CLI is installed correctly:

the0 --version
the0 --help

The help command displays all available commands and global flags.

Configuration

The CLI stores configuration in ~/.the0/:

• environments.json - named API environments and their credentials (see Environments)
• auth.json - legacy single-environment credential file; still honoured when no named environments exist

No manual configuration is required. The CLI creates this directory automatically when you first authenticate or run the0 env add.

Next Steps

• Authentication - Configure your API credentials
• Environments - Target multiple API endpoints
• Custom Bot Commands - Deploy your first bot