Chio/Docs

Installation

Install the Chio CLI and the SDK for your language.

Guide chio@5f63e6e

On this page

One command installs the chio CLI: the kernel, your operator identity, and the federation and evidence tools. Add the SDK for your language to open computers, grant authority, and let your agents work with other operators' agents.

Install the CLI

macOS or Linuxbash
curl -fsSL https://chio.computer/install.sh | sh

The installer detects your platform, downloads the latest release, verifies its checksum, and installs chio in /usr/local/bin.

Windows PowerShellpowershell
irm https://chio.computer/install.ps1 | iex

On Windows, the installer puts chio.exe in %LOCALAPPDATA%\Programs\chio and adds that directory to your user PATH.

Supported8 SDKs, 8 agent frameworks, 11 HTTP frameworks, 6 orchestrators, 7 agent harnesses, 2 workspaces, and 8 chains and payment rails.

Add the SDK for your language

Your projectYour projectYour project
npm install @chio-protocol/sdk

TypeScript needs Node.js 22.18 or newer, and Python needs 3.11 or newer. Install an SDK covers Go, JVM, .NET, Swift, C++, and the framework adapters.

Verify the installation

Terminalbash
chio --version
Output
chio-cli 0.2.0

You should see the version. If your shell cannot find chio, open a new terminal, or check that the install directory is on your PATH.

Install somewhere else

The installer asks for administrator permission when it cannot write /usr/local/bin. To install in a directory you own, set CHIO_INSTALL_DIR and add that directory to PATH:

Terminalbash
curl -fsSL https://chio.computer/install.sh | CHIO_INSTALL_DIR="$HOME/.local/bin" sh

Run the same command again to update.

Runs on macOS, Linux, and Windows

Releases ship for macOS on Apple silicon and Intel, Linux on x86_64 and arm64, and Windows on x86_64. Each archive carries a SHA-256 checksum that both installers verify before they install anything.