Démarrage rapide du SDK Python

Trouver un GPU, le louer et se connecter en SSH — le tout depuis Python ou le terminal en 5 minutes

Ce que vous allez construire : En 5 minutes, vous rechercherez sur le marché des GPU, louerez un serveur et vous connecterez via SSH — le tout depuis du code ou la CLI.

Prérequis

• Python 3.9+ installé

• Compte Clore.ai — inscrivez-vous ici

• Clé API — obtenez-la depuis votre tableau de bord Clore.ai

• Fonds — minimum ~5 $ en BTC, CLORE, USDT ou USDC

---

Étape 1 : Installer le SDK

pip install clore-ai

Vérifier l'installation :

clore --version

---

Étape 2 : Configurez votre clé API

Option A : Variable d'environnement (recommandé)

export CLORE_API_KEY=your_api_key_here

Option B : Configuration CLI (enregistrée dans ~/.clore/config.json)

clore config set api_key YOUR_API_KEY

---

Étape 3 : Rechercher un GPU

CLI

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

Vous verrez un tableau avec les ID des serveurs, les spécifications GPU, la RAM, le prix et la localisation.

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

Sortie :

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

Astuce : La marketplace() méthode filtre côté client. Vous pouvez aussi filtrer par min_gpu_count, min_ram_gb, et available_only (par défaut : True).

---

Étape 4 : Déployer (Louer un serveur)

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

Le premier démarrage prend 1 à 5 minutes. Le serveur télécharge l'image Docker et démarre les services. Si pub_cluster est None, attendez et vérifiez à nouveau avec my_orders().

---

Étape 5 : Se connecter via SSH

CLI (connexion automatique)

clore ssh 38

La CLI recherche la commande, trouve l'IP publique et le port SSH, et exécute ssh pour vous.

SSH manuel

ssh root@<pub_cluster> -p <ssh_port>
# Mot de passe : MySecurePass123

---

Étape 6 : Nettoyage

Lorsque vous avez terminé, annulez la commande pour arrêter la facturation :

CLI

clore cancel 38

Python

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

---

Script complet : Rechercher → Déployer → Surveiller → Annuler

from clore_ai import CloreAI
import time

client = CloreAI()  # Utilise la variable d'env CLORE_API_KEY

# 1. Trouver le RTX 4090 le moins cher
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("Aucun RTX 4090 disponible à moins de 5 $/h")
    exit(1)

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

# 2. Déployer
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. Attendre l'attribution de l'IP
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"Prêt ! SSH : ssh root@{current.pub_cluster} -p {current.tcp_ports.get('22', 22)}")
        break
    print("En attente du démarrage du serveur...")
    time.sleep(10)

# 4. ... faites votre travail ...

# 5. Annuler une fois terminé
client.cancel_order(order_id=order.id)
print("Commande annulée, facturation arrêtée.")

---

Et après ?

Guide	Ce que vous apprendrez
Guide du SDK Python	Opérations asynchrones, marché spot, gestion des serveurs, gestion des erreurs
Automatisation CLI	Scripts Bash, intégration CI/CD, déploiement en lot
Intégration API	Connectez les services IA exécutés sur Clore à vos applications
Comparaison GPU	Choisir le bon GPU pour votre charge de travail

---

Bonne location de GPU ! 🚀