Metadata-Version: 2.4
Name: lambda-ai-cloud-api-client
Version: 1.3.0
Summary: A client library for accessing Lambda Cloud API
Keywords: lambda,cloud,api,cli,compute,gpu
Author: Alexander van Eck
Author-email: Alexander van Eck <alexander@x-all.nl>
License-Expression: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Internet
Requires-Dist: httpx>=0.23.0,<0.29.0
Requires-Dist: attrs>=22.2.0
Requires-Dist: python-dateutil>=2.8.0,<3
Requires-Dist: click>=8.3.1
Requires-Dist: rich>=13.9.4
Requires-Python: >=3.10
Project-URL: Changelog, https://github.com/alexandervaneck/lambda-ai-cloud-api-client/blob/main/CHANGELOG.md
Project-URL: Homepage, https://github.com/alexandervaneck/lambda-ai-cloud-api-client
Project-URL: Issues, https://github.com/alexandervaneck/lambda-ai-cloud-api-client/issues
Project-URL: Repository, https://github.com/alexandervaneck/lambda-ai-cloud-api-client
Description-Content-Type: text/markdown

# Lambda Cloud API - CLI

This repo contains the generated Python client for the Lambda Cloud API and a lightweight CLI wrapper so you can call it
directly from your terminal. The documentation for the api can be found here: https:/docs-api.lambda.ai/api/cloud

## Running the CLI locally

1. Set your API token via `LAMBDA_CLOUD_TOKEN` (or `LAMBDA_CLOUD_API_TOKEN` / `LAMBDA_API_TOKEN`), optionally
   `LAMBDA_CLOUD_BASE_URL` if you use a non-default endpoint.
2. Install this CLI: `uv pip install lambda-ai-cloud-api-client`.
3. Run commands: `lambda-ai <command> ...`

Examples:

- List instance types: `lambda-ai instance-types` (add `--available-only` to show only types with capacity, `--cheapest` to filter to the lowest price)
- Table view of types: `lambda-ai types` (filters: `--available-only`, `--cheapest`, `--region`, `--gpu`, `--min-gpus`, `--min-vcpus`, `--min-memory`, `--max-price`)
- List images: `lambda-ai images`
- List SSH keys: `lambda-ai ssh-keys`
- List instances: `lambda-ai instances ls`
- Shortcut table view: `lambda-ai ls` (renders a table; supports `--region` multiple times)
- Quick launch: `lambda-ai start --region us-east-1 --instance-type gpu_1x_a10 --ssh-key my-key`
- Quick stop: `lambda-ai stop <id-1> <id-2>`
- Get one instance: `lambda-ai instances get <instance-id>`
- Launch an instance:
  `lambda-ai instances launch --region us-east-1 --instance-type gpu_1x_a10 --ssh-key my-key --name demo`
- Terminate instances: `lambda-ai instances terminate <id-1> <id-2>`

Flags:

- `--token` to override the token (instead of env vars)
- `--base-url` to target a specific control plane (defaults to `https://cloud.lambdalabs.com`)
- `--insecure` to skip TLS verification (only for debugging)
