Cerebrium CLI

Command-line interface for Cerebrium - the serverless infrastructure platform for deploying AI and compute workloads with instant scaling.

Installation

Python (pip)

pip install cerebrium

macOS

# Using Homebrew (recommended)
brew tap cerebriumai/tap
brew install cerebrium

# Or download the latest release directly
curl -L https://github.com/CerebriumAI/cerebrium/releases/latest/download/cerebrium_cli_darwin_arm64.tar.gz | tar xz
sudo mv cerebrium /usr/local/bin/
# For Intel Macs, use: cerebrium_cli_darwin_amd64.tar.gz

Note: Code signing and notarization are coming soon. In the meantime, if macOS blocks the binary, remove the quarantine flag:

xattr -d com.apple.quarantine $(which cerebrium)

Or right-click the binary in Finder → Open → confirm the security prompt.

Linux

# Download the latest release
curl -L https://github.com/CerebriumAI/cerebrium/releases/latest/download/cerebrium_cli_linux_amd64.tar.gz | tar xz
sudo mv cerebrium /usr/local/bin/
# For ARM64, use: cerebrium_cli_linux_arm64.tar.gz

# Or install via package manager (Ubuntu/Debian)
wget https://github.com/CerebriumAI/cerebrium/releases/latest/download/cerebrium_linux_amd64.deb
sudo dpkg -i cerebrium_linux_amd64.deb

Windows

PowerShell (Run as Administrator):

# Download the latest release for AMD64
Invoke-WebRequest -Uri "https://github.com/CerebriumAI/cerebrium/releases/latest/download/cerebrium_cli_windows_amd64.zip" -OutFile "cerebrium.zip"

# Extract the archive
Expand-Archive -Path "cerebrium.zip" -DestinationPath "."

# Move to a directory in PATH
New-Item -ItemType Directory -Force -Path "C:\Program Files\cerebrium"
Move-Item -Force cerebrium.exe "C:\Program Files\cerebrium\cerebrium.exe"

# Add to PATH (permanent)
$env:Path += ";C:\Program Files\cerebrium"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::Machine)

# Clean up
Remove-Item cerebrium.zip

Or download manually:

1. Visit https://github.com/CerebriumAI/cerebrium/releases/latest
2. Download cerebrium_cli_windows_amd64.zip (or arm64 for ARM)
3. Extract and add cerebrium.exe to your PATH

Note: Package manager support (Chocolatey/Scoop) coming soon!

Verify Installation

cerebrium version

Usage

The CLI provides commands for managing your Cerebrium apps and infrastructure:

cerebrium [command]

Available Commands:
  deploy      Deploy your application to Cerebrium
  login       Authenticate with Cerebrium
  logs        View application logs
  apps         Manage applications (list, delete, describe)
  projects     Manage projects
  run         Execute code in your project context
  status      Check service status

Run "cerebrium [command] --help" for detailed usage information.

Documentation

In order to start building with Cerebrium, you can check out the following resources:

• Getting Started: Introduction Guide
• Configuration: TOML Reference
• Full Documentation: docs.cerebrium.ai
• API Reference: api.cerebrium.ai
• Examples: github.com/CerebriumAI/examples

Development

This CLI is written in Go and uses:

• Cobra for command structure
• Bubble Tea for interactive UI
• Viper for configuration management

To build from source:

git clone https://github.com/CerebriumAI/cerebrium.git
cd cerebrium
make build
./bin/cerebrium version

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Support

• Issues: GitHub Issues
• Discord: Join our community
• Email: support@cerebrium.ai

License

MIT - See LICENSE for details.