lyceum-cli 1.1.0

Command-line interface for Lyceum Cloud

Lyceum CLI

Run Python, Docker, and AI inference workloads on Lyceum Cloud GPUs from your terminal.

Installation

Recommended (isolated environment, no dependency conflicts):

uv tool install lyceum-cli
# or
pipx install lyceum-cli

Or with pip:

pip install lyceum-cli

Quickstart

# Authenticate via browser
lyceum auth login

# Run Python code on a GPU
lyceum python run train.py -m gpu.l40s

# Find the best GPU for your training script
lyceum gpu recommend train.py

# Run a Docker image
lyceum docker run python:3.11 -c "python -c 'print(1+1)'"

# Chat with a serverless model (billed per token, no deployment needed)
lyceum infer models
lyceum infer chat -m minimax/minimax-m3 -p "Hello"

# Or deploy a HuggingFace model on dedicated GPUs
lyceum infer deploy meta-llama/Llama-3.1-8B-Instruct
lyceum infer chat -d <deployment-id> -p "Hello"

# Inspect past runs
lyceum jobs history
lyceum jobs logs <execution-id>
lyceum jobs metrics <execution-id>

# Start a GPU VM with SSH access
lyceum vm start -h a100 -k "ssh-ed25519 AAAA..."

# Manage cloud storage
lyceum storage ls
lyceum storage upload ./data --recursive

Commands

Command	Description
lyceum python	Execute Python code or files on cloud GPUs
lyceum docker	Run Docker containers
lyceum compose	Run Docker Compose applications
lyceum notebook	Launch Jupyter notebooks
lyceum jobs	List, inspect, and abort executions (status, logs, metrics)
lyceum gpu	Recommend the optimal GPU for your code; list machine types
lyceum infer	Serverless chat/embeddings and dedicated deployments
lyceum storage	Manage files in cloud storage
lyceum env	Encrypted environment variables for executions
lyceum vm	Start and manage GPU VMs
lyceum auth	Login, logout, status, personal API keys
lyceum org	Organizations, members, billing, org API keys

Run lyceum <command> --help for details on any command. Most list/status commands accept --json for machine-readable output.

Configuration

Credentials and settings live in ~/.lyceum/config.json. Useful environment variables:

• LYCEUM_ORG — override the active organization slug
• IRIS_PROXY_URL — override the inference proxy URL

Links

• Dashboard
• Documentation
• Support: [e-mail]