CLI
Overview
For those who prefer the terminal. Spin up GPUs, deploy code, manage your account. No GUI required, no friction added.
Installation
macOS / Linux
curl -sSL https://basilica.ai/install.sh | bashVerify with basilica --version.
Commands
Authentication
GPU Rentals
| Command | Description |
|---|---|
ls | List available GPU instances |
up | Start a GPU rental |
ps | List active rentals |
status | Check rental status |
logs | View instance logs |
down | Terminate a rental |
restart | Restart instance container |
exec | Execute commands on instance |
ssh | SSH into instance |
cp | Copy files to/from instance |
Deployments
| Command | Description |
|---|---|
deploy | Deploy an application |
deploy ls | List deployments |
deploy status | Get deployment status |
deploy logs | Stream deployment logs |
deploy scale | Scale replicas |
deploy delete | Delete a deployment |
deploy vllm | Deploy vLLM server |
deploy sglang | Deploy SGLang server |
Account Management
| Command | Description |
|---|---|
balance | Check credit balance |
fund | Show deposit address |
fund list | List deposit history |
tokens | Manage API tokens |
ssh-keys | Manage SSH keys |
Run basilica <command> --help for detailed options.
Configuration
Config lives in ~/.config/basilica/. Auth data in ~/.local/share/basilica/.
| Environment Variable | Description |
|---|---|
BASILICA_API_TOKEN | API token for authentication |
BASILICA_API_URL | API endpoint URL |
Infrastructure Sources
| Name | Description | Best For |
|---|---|---|
| The Bourse | Decentralized GPU network, competitive pricing | Development, cost optimization |
| The Citadel | Datacenter infrastructure with SLAs | Production workloads |
Filter by source using --compute bourse or --compute citadel.
Auto-Login
Not logged in? No problem. Commands that need auth will prompt you automatically.
Exit Codes
| Code | Meaning |
|---|---|
0 | Success |
1 | General error |
2 | Authentication error |
3 | Network error |
4 | Resource not found |
Next Steps
- Authentication: Login and credential management
- GPU Rentals: Rent and manage GPU instances
- Deployments: Deploy applications
- Account Management: Billing and account settings