Installation Guide

Comprehensive installation instructions for Ralph Orchestrator.

Prerequisites

• OS: macOS, Linux, or Windows
• Node.js: 18+ (required for npm installs)
• Rust: 1.70+ (required for cargo installs)

Installation Methods

Method 1: npm (Recommended)

npm install -g @ralph-orchestrator/ralph-cli

Method 2: GitHub Releases installer

curl --proto '=https' --tlsv1.2 -LsSf \\
  https://github.com/mikeyobrien/ralph-orchestrator/releases/latest/download/ralph-cli-installer.sh | sh

Method 3: Cargo

cargo install ralph-cli

Method 4: Prebuilt Binary (cargo-dist)

Download the latest ralph-cli-<target>.tar.xz artifact from GitHub Releases, extract it, then place ralph on your PATH.

# Example (replace with the correct archive for your platform)
mkdir -p ~/bin
curl -L -o ralph.tar.xz "<release-archive-url>"
tar -xJf ralph.tar.xz
mv ralph ~/bin/

Homebrew is not currently published from this repository's automated release flow.

Verify Installation

ralph --version

Next Steps

• Install at least one supported AI backend CLI (Claude Code, Gemini CLI, Copilot CLI, etc.)
• Configure your backend API keys or auth
• Follow the quick start guide: getting-started/quick-start.md