Skip to main content

Installation

The Chamber CLI is currently in early access. Contact support@usechamber.com to get access.

First-Time Setup

Chamber guides you through everything. Just run chamber login and follow the prompts. No manual configuration required.

Step 1: Login

chamber login
This opens your browser to authenticate. After logging in, you’re automatically configured.
For CI/CD or headless servers, use token-based auth:
chamber login --token ch.your-api-token
Generate tokens in the Chamber Dashboard under Settings > API Tokens.
The AI Assistant (chamber chat) requires browser-based login and does not support API tokens.

Step 2: Verify

chamber whoami
That’s it! You’re ready to submit workloads.

Submit Your First Workload

Navigate to your training code and run:
chamber run ./my-training-project --gpus 4 --team <team-id> --dry-run
First time? The --dry-run flag shows you exactly what Chamber will generate without actually building or submitting. Remove it when you’re ready to run for real.

What happens next

If it’s your first time, Chamber will interactively guide you through:
  1. Registry setup — Choose Google Artifact Registry, AWS ECR, or another registry
  2. Docker installation — If Docker isn’t installed, Chamber offers to help
  3. Cloud CLI setup — If AWS CLI or gcloud isn’t configured, Chamber walks you through it
$ chamber run ./my-project --gpus 4 --team abc123

No container registry configured

Chamber needs a container registry to store your Docker images.

Select your registry type:

  [1] Google Artifact Registry (recommended for GCP users)
  [2] AWS ECR (recommended for AWS users)
  [3] Other Docker registry

Select an option [1]:
After the one-time setup, future runs are instant:
# This just works now
chamber run ./my-project --gpus 4 --team abc123

Optional: Set Your Organization

If you belong to multiple organizations, set a default:
chamber config set organization_id your-org-id
Find your organization ID in the Chamber Dashboard under Settings > Organization.

Shell Completion

Enable tab completion for faster workflows:
# Add to ~/.bashrc
source <(chamber completion bash)

Next Steps