Installation

One-command install

The fastest path — downloads the pre-built binary for your platform:

macOS / Linux

curl -fsSL https://h-uman.ai/install.sh | sh

Windows (PowerShell)

irm https://h-uman.ai/install.ps1 | iex

Docker

docker pull ghcr.io/sethdford/h-uman:latest
docker run -it ghcr.io/sethdford/h-uman:latest agent

Mac users: The installer offers to set up Apple Intelligence automatically — on-device AI with no API keys, no cloud, no cost.

Windows users: Human runs inside WSL (Windows Subsystem for Linux). The PowerShell script installs WSL if needed, then installs human inside it.

:::tip Other install methods Homebrew: brew install --HEAD ./Formula/human.rb | Debian/Ubuntu: .deb packages available in GitHub releases | Nix: nix run github:sethdford/h-uman :::

Prerequisites

Before building, ensure you have:

• C compiler — GCC or Clang (C11)
• CMake 3.16 or later
• SQLite3 — for the SQLite memory backend; omit to use markdown-only (-DHU_ENABLE_SQLITE=OFF)
• libcurl — for HTTP/HTTPS and cloud providers; omit for minimal builds (-DHU_ENABLE_CURL=OFF)

macOS

brew install cmake sqlite3
# libcurl is usually included with Xcode Command Line Tools

Linux (Debian/Ubuntu)

sudo apt-get update
sudo apt-get install -y build-essential cmake libsqlite3-dev libcurl4-openssl-dev

Linux (Fedora)

sudo dnf install -y cmake sqlite-devel libcurl-devel

Clone and build

Clone the repository, then build:

git clone https://github.com/sethdford/h-uman.git
cd h-uman
mkdir -p build && cd build
cmake .. -DCMAKE_BUILD_TYPE=MinSizeRel -DHU_ENABLE_LTO=ON -DHU_ENABLE_ALL_CHANNELS=ON -DHU_ENABLE_CURL=ON
cmake --build . -j$(nproc)

The binaries are produced in build/:

• build/human — main CLI
• build/human_tests — test suite

Release build (minimal size)

mkdir -p build && cd build
cmake .. -DCMAKE_BUILD_TYPE=MinSizeRel -DHU_ENABLE_LTO=ON -DHU_ENABLE_ALL_CHANNELS=ON
cmake --build .

This produces a small binary (~1.7 MB with LTO) and enables all messaging channels (Telegram, Discord, Slack, etc.).

Basic development build

mkdir -p build && cd build
cmake .. -DHU_ENABLE_ALL_CHANNELS=ON
cmake --build .

Development build with AddressSanitizer

For detecting memory errors during development:

cmake -B build -DHU_ENABLE_ASAN=ON -DHU_ENABLE_ALL_CHANNELS=ON
cmake --build build
./build/human_tests

Build options

Option	Default	Description
HU_ENABLE_ALL_CHANNELS	OFF	Build all 38 channels (CLI, Telegram, Discord, etc.)
HU_ENABLE_LTO	OFF	Link-time optimization for smaller binaries
HU_ENABLE_ASAN	OFF	AddressSanitizer for memory debugging
HU_ENABLE_SQLITE	ON	SQLite memory backend
HU_ENABLE_CURL	ON	libcurl for HTTP clients

Per-channel options (HU_ENABLE_TELEGRAM, HU_ENABLE_DISCORD, etc.) are available if you want a minimal build with only specific channels.

Verify installation

Confirm the binary runs:

./build/human --help

Example output:

human v0.1.0 — Autonomous AI Assistant Runtime (C/ASM/WASM)

Usage: human [command] [options]

Commands:
  agent          Run the agent loop
  doctor         Run diagnostics
  onboard        First-run setup wizard
  ...

Run diagnostics to check config and provider setup:

./build/human doctor

Example output (with valid config):

[doctor] config: ok (loaded from /home/user/.human/config.json)
[doctor] provider (ollama): ok (local — no API key required)
[doctor] memory engine: sqlite

If config is missing, run the onboard wizard first (see Quick Start).

Run tests

./build/human_tests

All 8,400+ tests must pass with zero ASan errors.