v8x - The Vantage Compute CLI

The unified command-line interface for Vantage Compute

v8x is a modern async Python tool that unifies authentication, profile management, cluster operations and GraphQL querying against the Vantage Compute platform.

Quick Start

Run with uvx:

uvx v8x

Or from source:

git clone https://github.com/vantagecompute/v8x
cd v8x
uv sync
uvx v8x --help

Authenticate

Authenticate against the Vantage platform using the login command.

uvx v8x login

Create a Multipass Singlenode Cluster

Create a cloud account first, then create the cluster:

uvx v8x cloud account create my-localhost --provider on_prem
uvx v8x cluster create my-slurm-multipass-cluster \
    --cloud-account-id <ID> \
    --app slurm-multipass \
    --cluster-type slurm

Create a Slurm Cluster in LXD Containers using Juju

uvx v8x cloud account create my-lxd --provider lxd --attributes '{"lxd_server_url":"...","lxd_token":"..."}'
uvx v8x cluster create my-slurm-lxd-cluster \
    --cloud-account-id <ID> \
    --app slurm-juju-localhost \
    --cluster-type slurm

Create a Slurm Cluster on MicroK8S

uvx v8x cloud account create my-microk8s --provider microk8s
uvx v8x cluster create my-slurm-microk8s-cluster \
    --cloud-account-id <ID> \
    --app slurm-microk8s-localhost \
    --cluster-type slurm

Next Steps

• CLI Quickstart – Install & Configure
• Commands Reference – Complete Command Reference
• Private Installation Configuration – Partner Vantage Deployment CLI Profile Configuration
• Usage Examples – Practical Command Patterns
• Architecture – Internals & Module Layout
• Troubleshooting – Common Issues and Solutions