lium ls
List available GPU nodes.
lium ls [OPTIONS]
Optionsโ
| Flag | Effect |
|---|---|
--gpu TYPE | Filter by GPU type (H100, A100, RTX4090, โฆ) |
--count N | Exact GPU count to match (e.g. 1, 8) |
--min-cuda VERSION | Minimum CUDA version supported by the node (e.g. 12.4) |
--lat LAT | Latitude for distance filtering |
--lon LON | Longitude for distance filtering |
--max-distance MILES | Maximum distance in miles from --lat/--lon |
--sort FIELD | Sort by download (default), upload, price_gpu, price_total, loc, id, or gpu |
--limit N | Limit the number of rows shown |
--format FORMAT | Output format: table (default) or json |
Examplesโ
lium ls # List all nodes
lium ls --gpu H100 # Only H100 GPUs
lium ls --min-cuda 12.4 # Only nodes supporting CUDA 12.4 or higher
lium ls --sort price_gpu # Cheapest $/GPUยทh first
lium ls --limit 10 # Show only the first 10 rows
lium ls --format json # JSON output
Pareto-optimal choices in the table are marked with โ .
Tier columnโ
Each node shows its Tier, so you can see the interruption risk before renting:
- secure โ the default. If the rental is interrupted, the provider is penalized (their rental fee is withheld), so these nodes are the stable choice.
- spot โ the provider can reclaim the node at any time with no penalty, and you are not compensated if the pod is interrupted. Use spot for cheaper, interruptible, fault-tolerant workloads.
With --format json, the same value is exposed as the tier field on each node ("spot", "secure", or null when unknown).
See Node Tier: Secure vs Spot for the full comparison.