Lium — Python SDK & CLI
lium.io is a Python package that provides both a command-line interface and a Python SDK for managing GPU pods on the Lium platform. Install it once — use whichever interface fits the job.
<p align="center" <img src="assets/web-app-logo.png" alt="Lium Logo" width="120" / </p
<h1 align="center"Lium</h1
<div align="center" <a href="https://docs.lium.io/developers/cli/quickstart"Quickstart</a <span • </span <a href="https://lium.io/?utmsource=github"Website</a <span • </span <a href="https://docs.lium.io/developers/cli/overview"CLI Docs</a <span • </span <a href="https://docs.lium.io/developers/sdk"SDK Docs</a <span • </span <a href="https://discord.gg/lium"Discord</a </div
Installation
Python package
pip install lium.ioBinary install (macOS amd64/arm64 / Linux amd64/arm64)
curl -fsSL https://lium.io/install.sh | bashFresh binary installs place a managed symlink at ~/.lium/bin/lium that points to a versioned binary under ~/.lium/versions/<version/lium.
Quick Start
CLI
# First-time setup: create an account (mints and stores an API key) …
lium signup --email you@example.com
# … or link an existing account (opens a browser). Headless (agents, CI, containers): pass the key
# instead — lium init --api-key sk_... (keys: https://lium.io/api-keys), or export LIUM_API_KEY and skip init.
lium init
lium balance
# List available nodes (GPU machines)
lium ls
# Create a pod using node index
lium up 1 # Use node #1 from previous lsOr create a pod using filters
lium up --gpu A100 # Auto-select best A100 node
List your pods
lium ps lium ps --filter status=RUNNING --sort spent # running pods, most expensive so far first lium spend # burn per hour, spend per pod, runway