Quickstart

From zero to your first autonomous run in about five minutes. Each step is copy-paste.

1 · Install

Grab the latest signed macOS binary from the download section (or the releases page), or build from source:

# prebuilt binary (macOS, Apple Silicon) — signed & notarized
tar -xzf rupu-*-aarch64-apple-darwin.tar.gz
chmod +x ./rupu && sudo mv ./rupu /usr/local/bin/rupu

# …or from source (any platform with Rust)
cargo install --git https://github.com/Section9Labs/rupu

rupu --version

2 · Initialize & connect a model

init scaffolds .rupu/ in the current repo with a set of starter agents and workflows; auth login connects a model provider (credentials are stored in your system keychain).

rupu init
rupu auth login          # pick anthropic / openai / gemini / copilot
rupu auth status

See Providers & Auth for the full provider + auth-mode list — and note each agent can use a different provider, so one workflow can mix models.

3 · Run your first agent

The starter set includes a code-reviewer agent. Point it at your current diff:

rupu run code-reviewer --prompt "Review the changes on this branch"

# everything is recorded as a JSONL transcript you can replay
rupu transcript --last

An agent is just a Markdown file (config in YAML frontmatter + a system prompt). Open .rupu/agents/code-reviewer.md to see one — full format in Agents.

4 · Run your first workflow

Workflows compose agents into steps. review-changed-files (bundled by init) fans a reviewer across every changed file in parallel, then summarizes:

rupu workflow run review-changed-files \
  --input files="$(git diff --name-only main...HEAD)"

List what's available with rupu workflow list. More shapes — sequential hand-offs, parallel review panels with gated fix-loops — in Workflows and Examples.

5 · Open the Control Plane

Prefer a browser? Launch the local web command center to author, launch, watch, and approve runs — including the drag-and-drop visual workflow editor:

rupu cp serve           # opens http://127.0.0.1:7878

Tour of every surface in Control plane.

6 · (Optional) Add a host

Drive rupu on another machine from this same Control Plane. On the remote, serve the API; on your machine, register it:

# on the remote machine (behind TLS)
rupu cp serve --bind 0.0.0.0:7878 --token "$RUPU_HOST_TOKEN" --no-open

# on your machine
rupu host add gpu-box --url https://gpu.internal --token "$RUPU_HOST_TOKEN"
rupu host list

Then pick the host in the launcher. See Multi-host.

Where to next