Quickstart
Get from zero to GPU in under 5 minutes. This guide covers installing the CLI, authenticating, joining an event, and connecting to your GPU blade.
1. Install the CLI
The rb CLI is distributed via pipx. Choose your platform:
brew install pipx
pipx install rb-cli
pip install pipx
pipx install rb-cli
Use WSL (Windows Subsystem for Linux). Then follow the Linux instructions above.
# Inside WSL terminal
pip install pipx
pipx install rb-cli
Verify the installation and enable tab completions:
$ rb --version
rb-cli 0.1.0
$ rb --install-completion
2. Sign up
Visit razorbridge.eu and create an account. You start with €10 free credit — no credit card required.
3. Authenticate
Log in from your terminal using the device auth flow:
$ rb auth login
Opening browser for authentication...
Waiting for approval...
✓ Logged in as [email protected]
Token expires in 1 hour (auto-refreshes)
Your browser will open for you to approve the device. Once approved, the CLI is authenticated.
4. Join an event
Enter the join code your professor shared:
$ rb event join CUDA-2026
✓ Joined "ML Workshop — Spring 2026"
GPU: L40S (48 GB VRAM)
Starts: 2026-03-15 09:00 CET
Duration: 3 hours
Participants: 12/40
Join codes are case-insensitive. Your professor may share them as CUDA-2026, cuda-2026, or any variation.
5. Connect to your GPU
Once the event starts and your blade is provisioned, connect with one command:
$ rb blade ssh
Connecting to [email protected]:22012...
Welcome to your razorBridge GPU Blade
GPU ready · CUDA + PyTorch pre-installed
student@gpu-blade:~$ nvidia-smi
rb blade ssh drops you straight onto the GPU. With sshpass installed it's fully passwordless; otherwise it prints the one-time password to paste.
To run a single command without opening a shell — handy for kicking off training or a quick check — use rb run:
$ rb run nvidia-smi
$ rb run "python train.py --epochs 10"
Prefer your editor? rb blade config --append writes an SSH alias so you can run ssh gpu-blade-abc123 — works directly with VS Code Remote-SSH, JetBrains Gateway, or any SSH client.
$ rb blade config --append
✓ Added gpu-blade-abc123 to ~/.ssh/config
Connect with: ssh gpu-blade-abc123
6. Transfer files
Once the SSH config alias from step 5 is in place, use standard scp or rsync to move files. Upload to your blade:
$ scp ./notebook.ipynb gpu-blade-abc123:~/
notebook.ipynb 100% 24KB 2.1MB/s 00:00
Download results:
$ scp -r gpu-blade-abc123:~/results/ ./
results/metrics.json 100% 4.2KB 1.0MB/s 00:00
results/model.pt 100% 152MB 88MB/s 00:01
What's next
- Inference Gates — use AI models via API, billed against your credits
- Blade CLI Reference — full command reference for blade management
- Troubleshooting — common issues and solutions