Référence CLI

Le clore L'interface CLI vous permet de gérer le marché GPU de Clore.ai directement depuis votre terminal — recherchez des GPU, déployez des instances, connectez-vous en SSH et gérez les commandes sans écrire de code.

---

Installation

pip install clore-ai

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

Exigences : Python 3.9+

---

Configuration

Définissez votre clé API

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

clore config set api_key VOTRE_CLEF_API

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

Ou utilisez une variable d'environnement

export CLORE_API_KEY=votre_clef_api_ici

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 sur le 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>	Voir le marché spot pour 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

Recherchez sur le marché GPU avec filtres et tri.

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

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

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

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

# Trier par nombre de GPU, afficher top 10
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	int	Nombre minimal de GPU
--min-ram	float	RAM minimale en GB
--max-price	float	Prix maximum en USD/heure
--sort	choix	Trier par : prix (par défaut), gpu, ram
--limit	int	Nombre max de résultats à afficher (par défaut : 20)

Exemple de sortie :

🔍 Marché GPU
┏━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ID  ┃ GPU                             ┃ Quant ┃ RAM (GB) ┃ 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 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 (obtenu 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, max 32 caractères)
--ssh-key	texte	Non	Clé publique SSH
--port	texte	Non	Mappage de port (répétable), format : PORT:PROTOCOL
--env	texte	Non	Variable d'environnement (répétable), format : CLE=VALEUR
--spot-price	float	Non	Prix spot par jour (requis pour les commandes spot)

---

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 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 une commande
clore cancel 38

# Annuler avec rapport de problème
clore cancel 38 --issue "Le GPU surchauffait"

Arguments :

Argument	Description
order_id	ID de la commande à annuler

Options :

Option	Description
--issue	Raison de l'annulation / rapport de problème

---

clore ssh <order_id>

Connexion automatique via SSH à une commande en cours. 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'utilisateur différent
clore ssh 38 --user ubuntu

Arguments :

Argument	Description
order_id	ID de la 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 le marché.

clore servers

---

clore server-config <name>

Obtenir 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 minimale de location : 72
GPU : NVIDIA GeForce RTX 4090
Prix à la demande (USD) : $0.35
Prix spot (USD) : $0.18
CPU : AMD Ryzen 9 5900X Processeur 12 cœurs
RAM : 64.0 GB
GPU : 1x NVIDIA GeForce RTX 4090

---

clore spot <server_id>

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

clore spot 6

Exemple de sortie :

📊 Marché spot - Serveur 6
┏━━━━━━━━━━┳━━━━━━━━━━━┓
┃ ID 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 diminuer les prix spot qu'une fois toutes les 600 secondes, et par une taille de pas limitée.

---

clore config

Gérer la configuration de la CLI.

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

# 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 typique de bout en bout :

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

# 2. Déployer sur le serveur le moins cher (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érifier le statut de votre commande
clore orders

# 4. Se connecter en SSH à l'instance (ex. ID de commande 456)
clore ssh 456

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

Surveiller les soldes avant de louer

# Vérifier 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érifier les offres spot pour un serveur
clore spot 6

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

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

Gestion de l'hébergement des serveurs

# Voir vos serveurs
clore servers

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

---

Étapes suivantes

• SDK Python — Automatisez les flux de travail avec Python

• API REST — Documentation de l'API brute

• On-Demand vs Spot — Comprendre les modèles de tarification