Python SDK Quickstart

Find a GPU, rent it, and SSH in — all from Python or terminal in 5 minutes

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.

Prerequisites

• Python 3.9+ installed

• Clore.ai account — sign up here

• API key — get it from your Clore.ai dashboard

• Funds — minimum ~$5 in BTC, CLORE, USDT, or USDC

---

Step 1: Install the SDK

pip install clore-ai

Verify installation:

clore --version

---

Step 2: Configure Your API Key

Option A: Environment variable (recommended)

export CLORE_API_KEY=your_api_key_here

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

clore config set api_key YOUR_API_KEY

---

Step 3: Search for a GPU

CLI

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

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

Tip: The marketplace() method filters client-side. You can also filter by min_gpu_count, min_ram_gb, and available_only (default: True).

---

Step 4: Deploy (Rent a Server)

CLI

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

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}")

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().

---

Step 5: Connect via SSH

CLI (auto-connects)

clore ssh 38

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

Manual SSH

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

---

Step 6: Cleanup

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

CLI

clore cancel 38

Python

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

---

Full Script: Search → Deploy → Monitor → Cancel

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	Async operations, spot market, server management, error handling
CLI Automation	Bash scripts, CI/CD integration, batch deploy
API Integration	Connect AI services running on Clore to your apps
GPU Comparison	Choose the right GPU for your workload

---

Happy GPU renting! 🚀