gcube CLI
Official command-line tool for the gcube AI GPU cloud platform. Manage GPU workloads, monitor resources, and stream container logs — all from your terminal.
Installation
pip install gcube-cli
Quick Start
# Authenticate (opens browser)
gcube auth login
# Check available GPUs — note the CODE column (e.g. 029)
gcube gpu list
# Register a workload (inline flags for single container)
gcube workload register --image ollama/ollama:latest --port 11434 \
--gpu 029 --description "my workload"
# Or use YAML for env vars, storage mounts, multi-container, etc.
gcube workload register --skeleton > workload.yaml
# fill in description / containerImage / gpuCode, then:
gcube workload register -f workload.yaml
# register prints the SER — use it below
gcube workload start <SER>
gcube workload logs <SER>
# stop when done — GPU billing continues while running
gcube workload stop <SER>
Commands
| Command | Description |
|---|---|
gcube auth login|logout|status |
Browser-based authentication (PKCE) |
gcube gpu list |
Available GPUs with specs and pricing |
gcube workload register|update|list|describe |
Manage workloads |
gcube workload start|stop|delete |
Start (with live deploy monitoring), stop, delete |
gcube workload watch |
Re-attach to deployment progress |
gcube workload logs|pods|ssh |
Logs, pod info, SSH access |
gcube workload schedule|unschedule |
Scheduled start/stop |
gcube storage list |
Personal storage list |
gcube resource workload |
GPU/CPU/memory/disk/network usage |
gcube point status|spending |
Point balance and spending history |
gcube credential list|create|delete |
Registry credentials |
gcube config set|get|status |
Configuration management |
gcube completion install |
Shell completion (bash/zsh/fish) |
gcube skill show|install |
AI agent skill for Claude Code, Cursor, etc. |
Aliases:
wl= workload,cred= credential. Usegcube <command> --helpfor detailed options.
CI / Headless
Browser login (gcube auth login) is unavailable in CI.
Generate a token at Access Token, then:
export GCUBE_ACCESS_TOKEN="<your-token>"
Or persist via config:
gcube config set --token "<your-token>"
Destructive commands prompt for confirmation — pass -y in non-interactive runs:
gcube workload stop <SER> -y
Output Formats
gcube -o json workload list # JSON
gcube -o yaml workload describe 2100 # YAML
gcube workload list # table (default)
Documentation
- User Guide: gcube Docs
- Support: gcube.ai@data-alliance.com
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gcube_cli-0.4.2.tar.gz.
File metadata
- Download URL: gcube_cli-0.4.2.tar.gz
- Upload date:
- Size: 182.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
27ce016d9ef483e555c5125806fc099f052ecbafd3de524a5a2d912e4085ac1a
|
|
| MD5 |
0c3834cb076e51bde61e5b1685c3ef37
|
|
| BLAKE2b-256 |
c0fd5340a537e561681fd6bbcd7c05601d0b55cd46e76fb96a1b11afba3d6cb8
|
File details
Details for the file gcube_cli-0.4.2-py3-none-any.whl.
File metadata
- Download URL: gcube_cli-0.4.2-py3-none-any.whl
- Upload date:
- Size: 112.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9aafcafdc84b129ff119b4f735c0d56f09ba6898667fa3d6713a5fb85d06d692
|
|
| MD5 |
9171ae13cc3bf4818c3dd584aea69eec
|
|
| BLAKE2b-256 |
f4f9338c8bf874df428db060bc360ab300ac5940abf3ad286ab4ad601d8cbaad
|
