Installation

Install Roboticus via the checksum-verified binary installer, from source, or from pre-built release artifacts. Requires Go ≥ 1.26 for building from source.

Quick Install

Linux/macOS/WSL binary installer (recommended):

bash <(curl -fsSL https://roboticus.ai/install.sh)

Pin a Linux/macOS/WSL release version:

curl -fsSL https://roboticus.ai/install.sh | sh -s -- --version v1.0.8

Native Windows PowerShell install:

irm https://roboticus.ai/install.ps1 | iex

Run Pre-Built Binary (No Installer)

If you prefer not to run install scripts, download the latest release artifact and run the binary directly.

Linux/macOS/WSL:

# 1) Download the right archive from /registry
$ tar xzf roboticus-*.tar.gz
$ chmod +x roboticus
$ ./roboticus --help
$ ./roboticus serve

Windows (PowerShell):

# 1) Download the right .zip from /registry
PS C:\> Expand-Archive .\roboticus-*.zip -DestinationPath .
PS C:\> .\roboticus.exe --help
PS C:\> .\roboticus.exe serve

Release artifacts and checksums: /registry

Installer Steps

Check prerequisites

Detects OS and architecture for binary selection

Download release binary

Downloads the matching GitHub Releases binary and verifies it against SHA256SUMS.txt

Verify installation

Checks the binary is on PATH, prints version

Install on PATH

Installs the binary to /usr/local/bin on Linux/macOS or %LOCALAPPDATA%\roboticus on Windows

Installer Controls

Control	Description
`--version / -v`	Specific Linux/macOS/WSL version to install (default: latest GitHub release)
`-Version`	Specific Windows PowerShell version to install (default: latest GitHub release)
`-InstallDir`	Custom Windows install directory
`ROBOTICUS_ALLOW_UNVERIFIED`	Set to 1 only for explicit offline/debug bypass of checksum-tool enforcement

Build from Source

# Clone and build
$ git clone https://github.com/robot-accomplice/roboticus.git
$ cd roboticus
$ go build -o roboticus .

# The binary is at:
# ./roboticus

# Or build from a local clone
$ git clone https://github.com/robot-accomplice/roboticus.git
$ cd roboticus && go build -o roboticus .

Prerequisites

Go Toolchain

Go ≥ 1.26 (only needed for building from source). Install via go.dev/dl

Pre-built binaries require no toolchain.
Building from source: go build -o roboticus .

Pre-Built Binaries

SHA256-verified binaries for Linux (amd64/arm64), macOS (amd64/arm64), and Windows (amd64).

macOS: bash <(curl -fsSL https://roboticus.ai/install.sh)

Windows: irm https://roboticus.ai/install.ps1 | iex

Linux: Use the installer script above

Post-Install

$ roboticus setup       # Interactive configuration wizard
$ roboticus serve       # Start the agent runtime
$ roboticus dashboard   # Open the web dashboard
$ roboticus --help      # Show all commands

Configuration

Roboticus uses TOML configuration with 32+ sections (most optional with sensible defaults). Minimal config to get started:

[agent]
name = "MyAgent"
id = "my-agent"

[server]
port = 18789

[models]
primary = "ollama/qwen3:8b"

Configuration Sections

Section	Controls
`[models]`	Primary model, fallback chain, routing mode (heuristic or rule), local-first preference
`[providers.*]`	Per-provider URL, tier classification (T1–T4), API keys via env vars
`[memory]`	Token budget allocation across 5 memory tiers
`[cache]`	Exact-match TTL, semantic similarity threshold (default 0.95), max entries
`[treasury]`	Per-payment cap, hourly/daily transfer limits, minimum reserve, daily inference budget
`[skills]`	Skills directory, script timeout, allowed interpreters, sandbox mode, hot-reload
`[a2a]`	Max message size, rate limit per peer, session timeout, on-chain identity requirement
`[addressability]`	Alias names, mention-only mode, reply detection, DM bypass, composable filter chain