---
sidebar_position: 1
slug: /developers
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lium.io/llms.txt
> Use this file to discover all available pages before exploring further.
>
> Lium (lium.io) is a GPU rental marketplace: rent NVIDIA GPUs by the hour, billed per second.

# Developers

Use Lium from code: the REST API, the CLI, the Python SDK, MCP and llms.txt. The URLs below are stable.

Short on time? [Quickstart by task](/developers/quickstart-by-task) has a few-command path for each common job (quick experiment, training, vLLM, rent by spec, clusters, spend control), and [What's live on lium.io](/developers/availability) lists every live capability by surface.

## For AI agents

Start at **[AI Agents](/developers/agents)**, then read [Scripting for agents](/developers/agent-scripting) for non-interactive use.

- [`https://docs.lium.io/mcp`](/developers/mcp): docs MCP server, with live GPUs and prices
- [`https://docs.lium.io/llms-full.txt`](/developers/llms-txt): all docs as one markdown file
- [`https://lium.io/api/openapi.json`](/developers/api): live OpenAPI spec
- [`curl -fsSL https://lium.io/install.sh | bash`](/developers/cli/overview): the CLI

## For developers

One package, `lium.io`, ships the CLI and the Python SDK. Both use the key in `~/.lium/config.ini`.

**1. Install**

`pip install lium.io` or `curl -fsSL https://lium.io/install.sh | bash`. See [CLI installation](/developers/cli/installation).

**2. Sign in**

`lium signup` (new account) or `lium init` (existing account). See [`lium signup`](/developers/cli/reference/signup) and [`lium init`](/developers/cli/reference/init).

**3. Rent and use a pod from the shell**

`lium ls` → `lium up` → `lium ssh` / `lium exec` → `lium rm`. See the [CLI quickstart](/developers/cli/quickstart).

**4. Do the same in Python**

Use `Lium()`. See the [SDK](/developers/sdk) and the [pod lifecycle example](/developers/sdk/examples/pod-lifecycle).

**5. Run one function on a GPU**

Use `@lium.machine`. See [SDK → `@lium.machine`](/developers/sdk#liummachine-decorator) and the [remote inference example](/developers/sdk/examples/machine-inference).

**6. Call the REST API**

Send your key in `X-API-Key`. See the [Developer quickstart](/developers/quickstart) and [API](/developers/api).

The live Swagger UI is at [lium.io/documents](https://lium.io/documents).

## Community clients

Built and maintained by the community, not by Lium. Review the code before you give it your API key.

- [gpu402](https://github.com/GPU402/gpu402/tree/7293884dc278e2a2ec25d1df5240a4f6fb6810c7) (TypeScript): typed Lium client generated from the OpenAPI spec, with rent-cheapest, wait-until-ready, SSH exec, stop and budget helpers. `npm install --save-exact gpu402@0.2.0` (the reviewed version)
