Installation

RAPS CLI can be installed using several methods. Choose the one that best fits your needs.

Quick Install (Recommended)

The fastest way to get started is with our install scripts.

Linux/macOS

curl -fsSL https://raw.githubusercontent.com/dmytro-yemelianov/raps/main/install.sh | bash

This script:

Detects your OS and architecture automatically
Downloads the correct binary from GitHub releases
Verifies the SHA256 checksum
Installs to ~/.raps/bin
Updates your PATH (supports bash, zsh, and fish)

Options:

# Install specific version
RAPS_VERSION=3.11.0 curl -fsSL .../install.sh | bash

# Custom install directory
RAPS_INSTALL_DIR=/opt/raps/bin curl -fsSL .../install.sh | bash

# Skip PATH modification
RAPS_NO_MODIFY_PATH=1 curl -fsSL .../install.sh | bash

# Uninstall
curl -fsSL .../install.sh | bash -s -- --uninstall

Windows (PowerShell)

irm https://raw.githubusercontent.com/dmytro-yemelianov/raps/main/install.ps1 | iex

This script:

Detects your architecture (AMD64 or ARM64)
Downloads the correct binary from GitHub releases
Verifies the SHA256 checksum
Installs to ~\.raps\bin
Updates your User PATH

Options:

# Install specific version
$env:RAPS_VERSION = "3.11.0"; irm .../install.ps1 | iex

# Or with parameters (download first)
.\install.ps1 -Version "3.11.0"
.\install.ps1 -InstallDir "C:\Tools\raps"
.\install.ps1 -NoPathUpdate
.\install.ps1 -Uninstall

pip (Python)

If you have Python 3.8+ installed:

pip install raps

This installs platform-specific wheels that bundle the RAPS binary.

Available wheels:

Linux x64
macOS x64 and ARM64 (Apple Silicon)
Windows x64

Note: Linux ARM64 users should use the install script or download binaries directly.

Python Bindings

For programmatic Python access (not the CLI), install the native bindings:

pip install raps-bindings

This provides a Python library with full type hints:

from raps import Client

client = Client.from_env()
buckets = client.buckets.list()

📖 See Python Bindings for complete documentation.

Package Managers

npm (Node.js)

npm install -g @dmytro-yemelianov/raps-cli

Or run without installing:

npx @dmytro-yemelianov/raps-cli --version

Homebrew (macOS/Linux)

brew tap dmytro-yemelianov/raps
brew install raps

Scoop (Windows)

scoop bucket add raps https://github.com/dmytro-yemelianov/scoop-bucket
scoop install raps

Cargo (Rust)

If you have Rust installed:

cargo install raps

Requirements: Rust 1.88+ (rustup.rs)

Pre-built Binaries

Download from the Releases page:

Platform	Architecture	File
Windows	x64	`raps-cli-x86_64-pc-windows-msvc.zip`
macOS	Intel	`raps-cli-x86_64-apple-darwin.tar.xz`
macOS	Apple Silicon	`raps-cli-aarch64-apple-darwin.tar.xz`
Linux	x64	`raps-cli-x86_64-unknown-linux-gnu.tar.xz`
Linux	ARM64	`raps-cli-aarch64-unknown-linux-gnu.tar.xz`

Windows Installation

# Download and extract
Expand-Archive raps-cli-x86_64-pc-windows-msvc.zip -DestinationPath "$env:USERPROFILE\bin"

# Add to PATH
$env:PATH += ";$env:USERPROFILE\bin"

# Make permanent
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\bin", "User")

macOS/Linux Installation

# Extract the archive (.tar.xz format)
tar -xJf raps-cli-*.tar.xz

# Move to a directory in your PATH
sudo mv raps /usr/local/bin/

# Make executable
chmod +x /usr/local/bin/raps

# Verify installation
raps --version

Docker

docker pull ghcr.io/dmytro-yemelianov/raps:latest

# Run with environment variables
docker run --rm \
  -e APS_CLIENT_ID="your_id" \
  -e APS_CLIENT_SECRET="your_secret" \
  ghcr.io/dmytro-yemelianov/raps:latest auth test

GitHub Actions

- name: Install RAPS
  uses: dmytro-yemelianov/raps-action@v1

- name: Use RAPS
  run: raps auth test
  env:
    APS_CLIENT_ID: {'${{ secrets.APS_CLIENT_ID }}'}
    APS_CLIENT_SECRET: {'${{ secrets.APS_CLIENT_SECRET }}'}

Build from Source

# Clone the repository
git clone https://github.com/dmytro-yemelianov/raps.git
cd raps

# Build in release mode
cargo build --release

# Binary is at target/release/raps

Verify Installation

raps --version

You should see output like:

raps 4.3.0

Troubleshooting

”Permission denied” on install

Use a custom directory that you have write access to:

RAPS_INSTALL_DIR=$HOME/bin ./install.sh

“Command not found” after install

Your shell may not have reloaded the PATH. Try:

# Bash
source ~/.bashrc

# Zsh
source ~/.zshrc

# Fish
source ~/.config/fish/config.fish

Or open a new terminal window.

PowerShell execution policy

If you get an execution policy error:

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

Checksum verification failed

This usually means the download was corrupted. Try again or download manually from the Releases page.

Next Steps

After installation, configure your credentials.