Skip to main content

Installing Radium

This guide will help you install Radium on your system.

Prerequisites​

  • Operating System: Linux, macOS, or Windows (via WSL2)
  • Rust: 1.70 or later (for building from source)
  • API Keys: At least one of:
    • Anthropic API key (for Claude models)
    • Google AI API key (for Gemini models)
    • OpenAI API key (for GPT models)

Installation Methods​

Radium can be installed from source (recommended) or from pre-built binaries when available.

This is the recommended installation method as it ensures you have the latest version:

From Pre-built Binaries​

  1. Download the latest release for your platform from GitHub Releases

  2. Extract the archive:

    tar -xzf radium-*.tar.gz

  3. Move the binary to your PATH:

    sudo mv radium-*/rad /usr/local/bin/

  4. Verify installation:

    rad --version

  5. Clone the repository:

    git clone https://github.com/Unicorn/Radium.git
    cd RAD

  6. Build with Cargo:

    cargo build --release

  7. The compiled binary will be at ./target/release/rad

  8. Install system-wide (recommended):

    cargo install --path apps/cli

    This will install the rad command to your Cargo bin directory (typically ~/.cargo/bin/). Make sure this directory is in your PATH.

Quick Install Script (Alternative)​

If you prefer an automated installation, you can use the install script:

curl -sSf https://raw.githubusercontent.com/Unicorn/Radium/main/install.sh | sh

Note: The install script builds from source, so it requires Rust to be installed. It will:

  1. Clone the repository
  2. Build the project
  3. Install the rad CLI tool
  4. Add Radium to your PATH (if not already in Cargo bin PATH)

Configuration​

After installation, configure your API keys:

# Set your preferred AI provider API key
export ANTHROPIC_API_KEY="sk-ant-..."
# or
export GOOGLE_AI_API_KEY="..."
# or
export OPENAI_API_KEY="sk-..."

Add these to your shell profile (~/.bashrc, ~/.zshrc, etc.) to persist them.

Verify Installation​

Run the following command to verify everything is working:

rad --version
rad auth status

You should see the Radium version and your authentication status.

Next Steps​

Troubleshooting​

Command not found​

If you get "rad: command not found", ensure /usr/local/bin is in your PATH:

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Permission denied​

If you get permission errors, you may need to make the binary executable:

chmod +x /usr/local/bin/rad

Missing API key​

If you see authentication errors, ensure your API key is correctly set:

echo $ANTHROPIC_API_KEY  # Should output your API key

For more help, see the CLI Troubleshooting Guide or open an issue.