# Python SDK Quickstart

{% hint style="success" %}
**What you'll build:** In 5 minutes, you'll search the GPU marketplace, rent a server, and connect via SSH — all from code or CLI.
{% endhint %}

## Prerequisites

* **Python 3.9+** installed
* **Clore.ai account** — [sign up here](https://clore.ai)
* **API key** — get it from your [Clore.ai dashboard](https://clore.ai)
* **Funds** — minimum \~$5 in BTC, CLORE, USDT, or USDC

***

## Step 1: Install the SDK

```bash
pip install clore-ai
```

Verify installation:

```bash
clore --version
```

***

## Step 2: Configure Your API Key

**Option A: Environment variable (recommended)**

```bash
export CLORE_API_KEY=your_api_key_here
```

**Option B: CLI config (persisted to `~/.clore/config.json`)**

```bash
clore config set api_key YOUR_API_KEY
```

***

## Step 3: Search for a GPU

### CLI

```bash
clore search --gpu "RTX 4090" --max-price 5.0 --sort price --limit 10
```

You'll see a table with server IDs, GPU specs, RAM, price, and location.

### Python

```python
from clore_ai import CloreAI

client = CloreAI()

servers = client.marketplace(gpu="RTX 4090", max_price_usd=5.0)
for s in servers[:5]:
    print(f"Server {s.id}: {s.gpu_count}x {s.gpu_model} — ${s.price_usd:.4f}/h — {s.location}")
```

**Output:**

```
Server 142: 1x NVIDIA GeForce RTX 4090 — $0.0800/h — EU
Server 305: 1x NVIDIA GeForce RTX 4090 — $0.0950/h — US
Server 891: 2x NVIDIA GeForce RTX 4090 — $0.1200/h — EU
```

{% hint style="info" %}
**Tip:** The `marketplace()` method filters client-side. You can also filter by `min_gpu_count`, `min_ram_gb`, and `available_only` (default: `True`).
{% endhint %}

***

## Step 4: Deploy (Rent a Server)

### CLI

```bash
clore deploy 142 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MySecurePass123 \
  --port 22:tcp \
  --port 8888:http
```

### Python

```python
order = client.create_order(
    server_id=142,
    image="cloreai/ubuntu22.04-cuda12",
    type="on-demand",
    currency="bitcoin",
    ssh_password="MySecurePass123",
    ports={"22": "tcp", "8888": "http"}
)

print(f"Order created! ID: {order.id}")
print(f"IP: {order.pub_cluster}")
print(f"Ports: {order.tcp_ports}")
```

{% hint style="warning" %}
**First boot takes 1–5 minutes.** The server pulls the Docker image and starts services. If `pub_cluster` is `None`, wait and check again with `my_orders()`.
{% endhint %}

***

## Step 5: Connect via SSH

### CLI (auto-connects)

```bash
clore ssh 38
```

The CLI looks up the order, finds the public IP and SSH port, and runs `ssh` for you.

### Manual SSH

```bash
ssh root@<pub_cluster> -p <ssh_port>
# Password: MySecurePass123
```

***

## Step 6: Cleanup

When you're done, cancel the order to stop billing:

### CLI

```bash
clore cancel 38
```

### Python

```python
client.cancel_order(order_id=38, issue="Done with my work")
print("Order cancelled")
```

***

## Full Script: Search → Deploy → Monitor → Cancel

```python
from clore_ai import CloreAI
import time

client = CloreAI()  # Uses CLORE_API_KEY env var

# 1. Find cheapest RTX 4090
servers = client.marketplace(gpu="RTX 4090", max_price_usd=5.0)
servers.sort(key=lambda s: s.price_usd or float("inf"))

if not servers:
    print("No RTX 4090 available under $5/h")
    exit(1)

best = servers[0]
print(f"Best deal: Server {best.id} — ${best.price_usd:.4f}/h — {best.location}")

# 2. Deploy
order = client.create_order(
    server_id=best.id,
    image="cloreai/ubuntu22.04-cuda12",
    type="on-demand",
    currency="bitcoin",
    ssh_password="MySecurePass123",
    ports={"22": "tcp"}
)
print(f"Order {order.id} created!")

# 3. Wait for IP assignment
for _ in range(12):
    orders = client.my_orders()
    current = next((o for o in orders if o.id == order.id), None)
    if current and current.pub_cluster:
        print(f"Ready! SSH: ssh root@{current.pub_cluster} -p {current.tcp_ports.get('22', 22)}")
        break
    print("Waiting for server to start...")
    time.sleep(10)

# 4. ... do your work ...

# 5. Cancel when done
client.cancel_order(order_id=order.id)
print("Order cancelled, billing stopped.")
```

***

## What's Next

| Guide                                                                         | What You'll Learn                                                |
| ----------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| [Python SDK Guide](https://docs.clore.ai/guides/advanced/python-sdk)          | Async operations, spot market, server management, error handling |
| [CLI Automation](https://docs.clore.ai/guides/advanced/cli-automation)        | Bash scripts, CI/CD integration, batch deploy                    |
| [API Integration](https://docs.clore.ai/guides/advanced/api-integration)      | Connect AI services running on Clore to your apps                |
| [GPU Comparison](https://docs.clore.ai/guides/getting-started/gpu-comparison) | Choose the right GPU for your workload                           |

***

**Happy GPU renting! 🚀**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.clore.ai/guides/getting-started/python-quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.