référence CLI

Le clore La CLI vous permet de gérer la place de marché GPU Clore.ai directement depuis votre terminal — recherchez des GPU, déployez des instances, connectez-vous en SSH et gérez les commandes sans écrire une seule ligne de code.

---

Installation

pip install clore-ai

Cela installe à la fois le SDK Python et la clore commande CLI.

Prérequis : Python 3.9+

---

Configuration

Définissez votre clé API

Obtenez votre clé depuis le tableau de bord Clore.ai → API section, puis configurez :

clore config set api_key YOUR_API_KEY

Cela enregistre la clé dans ~/.clore/config.json.

Ou utilisez une variable d'environnement

export CLORE_API_KEY=your_api_key_here

Afficher la configuration actuelle

# Afficher toute la configuration
clore config show

# Obtenir une valeur spécifique
clore config get api_key

---

Commandes

Commande	Description
clore search	Rechercher dans la place de marché GPU
clore deploy <server_id>	Créer une nouvelle commande (louer un serveur)
clore orders	Lister vos commandes
clore cancel <order_id>	Annuler une commande
clore ssh <order_id>	Se connecter en SSH à une commande active
clore wallets	Afficher les soldes des portefeuilles
clore servers	Lister vos serveurs hébergés
clore server-config <name>	Obtenir la configuration du serveur
clore spot <server_id>	Afficher le marché spot d'un serveur
clore spot-price <order_id> <price>	Définir le prix spot
clore config set <key> <value>	Définir une valeur de configuration
clore config get <key>	Obtenir une valeur de configuration
clore config show	Afficher toute la configuration
clore --version	Afficher la version

---

Utilisation détaillée

clore search

Rechercher dans la place de marché GPU avec des filtres et un tri.

# Lister tous les serveurs disponibles (triés par prix, 20 premiers)
clore search

# Filtrer par modèle de GPU
clore search --gpu "RTX 4090"

# Filtrer par GPU et prix maximum
clore search --gpu "RTX 4090" --max-price 5.0

# Configurations multi-GPU
clore search --min-gpu 4

# Trier par nombre de GPU, afficher les 10 premiers
clore search --sort gpu --limit 10

# Combiner les filtres
clore search --gpu "A100" --min-ram 128 --max-price 10.0 --sort price --limit 5

Options :

Option	Type	Description
--gpu	texte	Filtrer par modèle de GPU (par ex. "RTX 4090")
--min-gpu	entier	Nombre minimum de GPU
--min-ram	flottant	Quantité minimale de RAM en Go
--max-price	flottant	Prix maximum en USD/heure
--sort	choix	Trier par : prix (par défaut), gpu, ram
--limit	entier	Nombre maximal de résultats à afficher (par défaut : 20)

Exemple de sortie :

🔍 Place de marché GPU
┏━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ID  ┃ GPU                             ┃ Nombre┃ RAM (Go) ┃ CPU                          ┃ Prix/h (USD) ┃ Emplacement ┃
┡━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ 123 │ 1x NVIDIA GeForce RTX 4090      │     1 │    64.0  │ AMD Ryzen 9 5900X            │       $0.3200 │ US       │
│ 456 │ 2x NVIDIA GeForce RTX 4090      │     2 │   128.0  │ Intel Core i9-13900K         │       $0.5800 │ DE       │
└─────┴─────────────────────────────────┴───────┴──────────┴──────────────────────────────┴───────────────┴──────────┘
Affichage de 2 serveurs

---

clore deploy <server_id>

Créer une nouvelle commande pour louer un serveur GPU.

# Commande à la demande avec SSH
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MySecurePass123 \
  --port 22:tcp \
  --port 8888:http

# Commande spot
clore deploy 123 \
  --image cloreai/pytorch \
  --type spot \
  --currency bitcoin \
  --spot-price 0.000005 \
  --port 22:tcp

# Avec des variables d'environnement
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MyPass123 \
  --port 22:tcp \
  --env WANDB_API_KEY=your_key \
  --env HF_TOKEN=your_token

Arguments :

Argument	Description
server_id	ID du serveur à louer (à obtenir depuis clore search)

Options :

Option	Type	Obligatoire	Description
--image	texte	Oui	Image Docker (par ex. cloreai/ubuntu22.04-cuda12)
--type	choix	Oui	on-demand ou spot
--currency	texte	Oui	Devise de paiement (par ex. bitcoin)
--ssh-password	texte	Non	Mot de passe SSH (alphanumérique, 32 caractères max)
--ssh-key	texte	Non	Clé publique SSH
--port	texte	Non	Mappage de port (répétable), format : PORT:PROTOCOLE
--env	texte	Non	Variable d'environnement (répétable), format : CLÉ=VALEUR
--spot-price	flottant	Non	Prix spot par jour (obligatoire pour les commandes spot)
--gpu-count	entier	Non	Louer seulement N GPU (location partielle, uniquement en on-demand)
--gpu-indices	texte	Non	Emplacements GPU séparés par des virgules depuis partial_gpu_rental.free_indices (nécessite --gpu-count)

---

clore orders

Lister vos commandes actives.

# Commandes actives
clore orders

# Inclure les commandes terminées/expirées
clore orders --completed

Options :

Option	Description
--completed	Inclure les commandes terminées/expirées

Exemple de sortie :

📦 Mes commandes
┏━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID ┃ ID du serveur ┃ Type      ┃ Statut ┃ Image                             ┃ IP                      ┃
┡━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 38 │ 6         │ on-demand │ Actif  │ cloreai/ubuntu22.04-cuda12        │ n1.c1.clorecloud.net    │
└────┴───────────┴───────────┴────────┴───────────────────────────────────┴─────────────────────────┘
Total : 1 commande

---

clore cancel <order_id>

Annuler une commande active.

# Annuler la commande
clore cancel 38

# Annuler avec signalement d'un problème
clore cancel 38 --issue "Le GPU surchauffait"

Arguments :

Argument	Description
order_id	ID de commande à annuler

Options :

Option	Description
--issue	Motif d'annulation / signalement du problème

---

clore ssh <order_id>

Connexion automatique via SSH à une commande en cours d'exécution. La CLI résout le nom d'hôte et le port à partir des détails de votre commande.

# Se connecter en tant que root (par défaut)
clore ssh 38

# Se connecter en tant qu'autre utilisateur
clore ssh 38 --user ubuntu

Arguments :

Argument	Description
order_id	ID de commande à laquelle se connecter

Options :

Option	Par défaut	Description
--user	root	Nom d'utilisateur SSH

---

clore wallets

Afficher les soldes de vos portefeuilles et les adresses de dépôt.

clore wallets

Exemple de sortie :

💰 Soldes des portefeuilles
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Devise         ┃ Solde        ┃ Adresse de dépôt                          ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ bitcoin          │ 0.00153176   │ tb1q6erw7v02t7hakgmlcl4wfnlykzqj05alndruwr │
│ CLORE-Blockchain │ 150.00000000 │ cLr1q8x...                                │
└──────────────────┴──────────────┴───────────────────────────────────────────┘

---

clore servers

Lister les serveurs que vous hébergez sur la place de marché.

clore servers

---

clore server-config <name>

Obtenez la configuration d'un serveur spécifique que vous hébergez.

clore server-config "MyGPU"

Exemple de sortie :

Serveur : MyGPU
ID : 42
Connecté : True
En ligne : True
Visibilité : public
Durée maximale de location : 72
GPU : NVIDIA GeForce RTX 4090
Prix à la demande (USD) : $0.35
Prix spot (USD) : $0.18
CPU : AMD Ryzen 9 5900X 12-Core Processor
RAM : 64.0 GB
GPU : 1x NVIDIA GeForce RTX 4090

---

clore spot <server_id>

Afficher les offres actuelles du marché spot pour un serveur.

clore spot 6

Exemple de sortie :

📊 Marché spot - Serveur 6
┏━━━━━━━━━━┳━━━━━━━━━━━┓
┃ ID de commande ┃ Prix     ┃
┡━━━━━━━━━━╇━━━━━━━━━━━┩
│ 39       │ 4.2e-06   │
└──────────┴───────────┘

---

clore spot-price <order_id> <price>

Mettre à jour le prix de votre offre sur le marché spot.

clore spot-price 39 0.000003

Remarque : Vous ne pouvez abaisser les prix spot qu'une fois toutes les 600 secondes, et par incréments limités.

---

clore config

Gérer la configuration de la CLI.

# Définir la clé API
clore config set api_key YOUR_API_KEY

# Obtenir une valeur
clore config get api_key

# Afficher toute la configuration
clore config show

La configuration est stockée dans ~/.clore/config.json.

---

Flux de travail

Rechercher → Louer → SSH → Annuler

Un flux de travail de bout en bout typique :

# 1. Trouvez une RTX 4090 à moins de 5 $/heure
clore search --gpu "RTX 4090" --max-price 5.0 --sort price --limit 5

# 2. Déployez sur le serveur le moins cher (par ex. ID 123)
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MyPass123 \
  --port 22:tcp \
  --port 8888:http

# 3. Vérifiez le statut de votre commande
clore orders

# 4. Connectez-vous en SSH à l'instance (par ex. ID de commande 456)
clore ssh 456

# 5. Une fois terminé, annulez la commande
clore cancel 456

Surveiller les soldes avant de louer

# Vérifiez que vous avez suffisamment de fonds
clore wallets

# Rechercher et louer
clore search --gpu "A100" --sort price --limit 3
clore deploy 789 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password SecurePass \
  --port 22:tcp

Flux de travail du marché spot

# 1. Vérifiez les offres spot d'un serveur
clore spot 6

# 2. Créez une commande spot
clore deploy 6 \
  --image cloreai/pytorch \
  --type spot \
  --currency bitcoin \
  --spot-price 0.000005 \
  --ssh-password MyPass123 \
  --port 22:tcp

# 3. Ajustez votre prix spot
clore spot-price 39 0.000003

Gestion de l'hébergement des serveurs

# Affichez vos serveurs
clore servers

# Vérifiez la configuration d'un serveur
clore server-config "MyGPU"

---

Étapes suivantes

• Python SDK — Automatisez les flux de travail avec Python

• API REST — Documentation brute de l'API

• À la demande vs Spot — Comprenez les modèles de tarification