Installation

Install Roboticus via the interactive installer, from source, or from pre-built binaries. Requires Go ≥ 1.26 for building from source.

Quick Install

Interactive installer for Linux/macOS/WSL (recommended):

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

Non-interactive Linux/macOS/WSL (skip all prompts):

curl -fsSL https://roboticus.ai/install.sh | ROBOTICUS_YES=1 bash

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 binary or build from source

Downloads SHA256-verified pre-built binary from GitHub Releases; falls back to go install if binary unavailable for your platform

Verify installation

Checks the binary is on PATH, prints version

Initialize workspace

Creates ~/.roboticus/ with default config, skill templates, empty database

Environment Variables

Variable	Description
`ROBOTICUS_VERSION`	Specific version to install (default: latest)
`ROBOTICUS_NO_INIT`	Skip 'roboticus init' after install (set to 1)
`ROBOTICUS_YES`	Skip all confirmation prompts (set to 1)
`GOBIN`	Custom Go binary directory (respected if set)

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 install to $GOBIN/
$ go install github.com/robot-accomplice/roboticus@latest

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: brew install robot-accomplice/tap/roboticus

Windows: winget install roboticus

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