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

# ...or register and start in one step (starts billing immediately)
gcube workload register -f workload.yaml --start

# 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`	Authentication — browser, or `--manual` without one
`gcube gpu list`	Available GPUs with specs and pricing
`gcube workload register\|update\|list\|describe`	Manage workloads (`register --start` to deploy right away)
`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\|update\|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. Use gcube <command> --help for detailed options.

SSH / Docker (no browser)

gcube auth login switches to manual mode on its own when no browser is available. Force it with gcube auth login --manual.

Manual mode prints a URL and a user code — approve on another device, then paste the 10-character authorization code back into the terminal.

CI / Headless

Both login modes need an interactive terminal, so 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

Apache License 2.0

Metadata

Release files for gcube-cli 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gcube-cli 0.5.0
File	Size	Uploaded	Provenance
gcube_cli-0.5.0.tar.gz	273.7 kB	Oct 19, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for gcube-cli 0.5.0
File	Interpreter	ABI	Platform	Reset
gcube_cli-0.5.0-py3-none-any.whl 154.2 kB Oct 19, 2026 Without provenance	Python 3	none	any	Details

Total release size: 427.9 kB

Release files / gcube_cli-0.5.0.tar.gz

Download URL	gcube_cli-0.5.0.tar.gz
Size	273.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`56237f50df831df014fbce4ee0998fae3a31340529cb7dec6f1717da7772f348`
BLAKE2b-256 checksum How to use checksums	`bdee4ae97d37834c9bdb91399f797e7fde370cbf5d5282c687d4a58c4a4bf070`
Upload date	Oct 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.10`

Release files / gcube_cli-0.5.0-py3-none-any.whl

Download URL	gcube_cli-0.5.0-py3-none-any.whl
Size	154.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`bb62a350790a73e4de74b01ee0844385e0db2b11764c94a0f1db9efd61f7bb86`
BLAKE2b-256 checksum How to use checksums	`3d598b966bfdd27b164ce05be830b317333729209f9565e84d9cd0c952e57b0c`
Upload date	Oct 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.10`

Security for gcube-cli 0.5.0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.