CLI-Referenz

Die clore Die CLI ermöglicht es Ihnen, den Clore.ai GPU-Marktplatz direkt von Ihrem Terminal aus zu verwalten — suchen Sie nach GPUs, starten Sie Instanzen, verbinden Sie sich per SSH und verwalten Sie Bestellungen, ohne Code zu schreiben.

---

Installation

pip install clore-ai

Dies installiert sowohl das Python-SDK als auch das clore CLI-Kommando.

Voraussetzungen: Python 3.9+

---

Konfiguration

Setzen Sie Ihren API-Schlüssel

Holen Sie Ihren Schlüssel vom Clore.ai-Dashboard → API Bereich, und konfigurieren Sie dann:

clore config set api_key YOUR_API_KEY

Dies speichert den Schlüssel in ~/.clore/config.json.

Oder verwenden Sie eine Umgebungsvariable

export CLORE_API_KEY=your_api_key_here

Aktuelle Konfiguration anzeigen

# Alle Konfigurationen anzeigen
clore config show

# Einen bestimmten Wert abrufen
clore config get api_key

---

Befehle

Befehl	Beschreibung
clore search	Den GPU-Marktplatz durchsuchen
clore deploy <server_id>	Eine neue Bestellung erstellen (Server mieten)
clore orders	Ihre Bestellungen auflisten
clore cancel <order_id>	Eine Bestellung stornieren
clore ssh <order_id>	Per SSH in eine aktive Bestellung einloggen
clore wallets	Wallet-Salden anzeigen
clore servers	Ihre gehosteten Server auflisten
clore server-config <name>	Serverkonfiguration abrufen
clore spot <server_id>	Spotmarkt für einen Server anzeigen
clore spot-price <order_id> <price>	Spot-Preis setzen
clore config set <key> <value>	Einen Konfigurationswert setzen
clore config get <key>	Einen Konfigurationswert abrufen
clore config show	Alle Konfiguration anzeigen
clore --version	Version anzeigen

---

Detaillierte Nutzung

clore search

Durchsuchen Sie den GPU-Marktplatz mit Filtern und Sortierung.

# Alle verfügbaren Server auflisten (nach Preis sortiert, Top 20)
clore search

# Nach GPU-Modell filtern
clore search --gpu "RTX 4090"

# Nach GPU und Max-Preis filtern
clore search --gpu "RTX 4090" --max-price 5.0

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

# Nach GPU-Anzahl sortieren, Top 10 anzeigen
clore search --sort gpu --limit 10

# Filter kombinieren
clore search --gpu "A100" --min-ram 128 --max-price 10.0 --sort price --limit 5

Optionen:

Option	Typ	Beschreibung
--gpu	Text	Nach GPU-Modell filtern (z. B. "RTX 4090")
--min-gpu	int	Minimale GPU-Anzahl
--min-ram	float	Minimale RAM-Größe in GB
--max-price	float	Maximaler Preis in USD/Stunde
--sort	Auswahl	Sortieren nach: Preis (Standard), GPU, RAM
--limit	int	Maximale Anzahl an Ergebnissen (Standard: 20)

Beispielausgabe:

🔍 GPU-Marktplatz
┏━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ID  ┃ GPU                             ┃ Anzahl┃ RAM (GB) ┃ CPU                          ┃ Preis/h (USD) ┃ Standort ┃
┡━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ 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       │
└─────┴─────────────────────────────────┴───────┴──────────┴──────────────────────────────┴───────────────┴──────────┘
Es werden 2 Server angezeigt

---

clore deploy <server_id>

Erstellen Sie eine neue Bestellung, um einen GPU-Server zu mieten.

# On-Demand-Bestellung mit SSH
clore deploy 123 \
  --image cloreai/ubuntu22.04-cuda12 \
  --type on-demand \
  --currency bitcoin \
  --ssh-password MySecurePass123 \
  --port 22:tcp \
  --port 8888:http

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

# Mit Umgebungsvariablen
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

Argumente:

Argument	Beschreibung
server_id	Server-ID zum Mieten (erhalten von clore search)

Optionen:

Option	Typ	Erforderlich	Beschreibung
--image	Text	Ja	Docker-Image (z. B. cloreai/ubuntu22.04-cuda12)
--type	Auswahl	Ja	on-demand oder spot
--currency	Text	Ja	Zahlungswährung (z. B. bitcoin)
--ssh-password	Text	Nein	SSH-Passwort (alphanumerisch, max. 32 Zeichen)
--ssh-key	Text	Nein	SSH-Public-Key
--port	Text	Nein	Port-Mapping (wiederholbar), Format: PORT:PROTOKOLL
--env	Text	Nein	Umgebungsvariable (wiederholbar), Format: KEY=VALUE
--spot-price	float	Nein	Spot-Preis pro Tag (erforderlich für Spot-Bestellungen)

---

clore orders

Ihre aktiven Bestellungen auflisten.

# Aktive Bestellungen
clore orders

# Abgeschlossene/abgelaufene Bestellungen einbeziehen
clore orders --completed

Optionen:

Option	Beschreibung
--completed	Abgeschlossene/abgelaufene Bestellungen einbeziehen

Beispielausgabe:

📦 Meine Bestellungen
┏━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID ┃ Server ID ┃ Typ       ┃ Status ┃ Image                             ┃ IP                      ┃
┡━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 38 │ 6         │ on-demand │ Aktiv  │ cloreai/ubuntu22.04-cuda12        │ n1.c1.clorecloud.net    │
└────┴───────────┴───────────┴────────┴───────────────────────────────────┴─────────────────────────┘
Insgesamt: 1 Bestellung

---

clore cancel <order_id>

Eine aktive Bestellung stornieren.

# Bestellung stornieren
clore cancel 38

# Mit Fehlerbericht stornieren
clore cancel 38 --issue "GPU wurde überhitzt"

Argumente:

Argument	Beschreibung
order_id	Bestell-ID zum Stornieren

Optionen:

Option	Beschreibung
--issue	Stornierungsgrund / Fehlerbericht

---

clore ssh <order_id>

Automatische Verbindung per SSH zu einer laufenden Bestellung. Die CLI löst Hostname und Port aus Ihren Bestelldaten auf.

# Als root verbinden (Standard)
clore ssh 38

# Als anderer Benutzer verbinden
clore ssh 38 --user ubuntu

Argumente:

Argument	Beschreibung
order_id	Bestell-ID, mit der verbunden werden soll

Optionen:

Option	Standard	Beschreibung
--user	root	SSH-Benutzername

---

clore wallets

Zeigen Sie Ihre Wallet-Salden und Einzahlungsadressen an.

clore wallets

Beispielausgabe:

💰 Wallet-Salden
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Währung          ┃ Saldo        ┃ Einzahlungsadresse                       ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ bitcoin          │ 0.00153176   │ tb1q6erw7v02t7hakgmlcl4wfnlykzqj05alndruwr │
│ CLORE-Blockchain │ 150.00000000 │ cLr1q8x...                                │
└──────────────────┴──────────────┴───────────────────────────────────────────┘

---

clore servers

Server auflisten, die Sie auf dem Marktplatz hosten.

clore servers

---

clore server-config <name>

Die Konfiguration eines bestimmten Servers abrufen, den Sie hosten.

clore server-config "MyGPU"

Beispielausgabe:

Server: MyGPU
ID: 42
Verbunden: True
Online: True
Sichtbarkeit: public
Minimale Mietdauer: 72
GPUs: NVIDIA GeForce RTX 4090
On-Demand-Preis (USD): $0.35
Spot-Preis (USD): $0.18
CPU: AMD Ryzen 9 5900X 12-Core Prozessor
RAM: 64.0 GB
GPU: 1x NVIDIA GeForce RTX 4090

---

clore spot <server_id>

Aktuelle Spotmarkt-Angebote für einen Server anzeigen.

clore spot 6

Beispielausgabe:

📊 Spotmarkt - Server 6
┏━━━━━━━━━━┳━━━━━━━━━━━┓
┃ Bestell-ID ┃ Preis     ┃
┡━━━━━━━━━━╇━━━━━━━━━━━┩
│ 39       │ 4.2e-06   │
└──────────┴───────────┘

---

clore spot-price <order_id> <price>

Den Preis Ihres Spotmarkt-Angebots aktualisieren.

clore spot-price 39 0.000003

Hinweis: Sie können Spot-Preise nur alle 600 Sekunden senken und nur um eine begrenzte Schrittgröße.

---

clore config

CLI-Konfiguration verwalten.

# API-Schlüssel setzen
clore config set api_key YOUR_API_KEY

# Einen Wert abrufen
clore config get api_key

# Alle Konfigurationen anzeigen
clore config show

Die Konfiguration wird gespeichert in ~/.clore/config.json.

---

Workflows

Suchen → Mieten → SSH → Stornieren

Ein typischer End-to-End-Workflow:

# 1. Finden Sie eine RTX 4090 für unter $5/Stunde
clore search --gpu "RTX 4090" --max-price 5.0 --sort price --limit 5

# 2. Auf dem günstigsten Server bereitstellen (z. B. 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. Den Bestellstatus prüfen
clore orders

# 4. Per SSH in die Instanz (z. B. Bestell-ID 456)
clore ssh 456

# 5. Wenn fertig, die Bestellung stornieren
clore cancel 456

Kontostände vor der Anmietung überwachen

# Prüfen Sie, ob Sie genügend Guthaben haben
clore wallets

# Suchen und mieten
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

Spotmarkt-Workflow

# 1. Spot-Angebote für einen Server prüfen
clore spot 6

# 2. Eine Spot-Bestellung erstellen
clore deploy 6 \
  --image cloreai/pytorch \
  --type spot \
  --currency bitcoin \
  --spot-price 0.000005 \
  --ssh-password MyPass123 \
  --port 22:tcp

# 3. Ihren Spot-Preis anpassen
clore spot-price 39 0.000003

Verwaltung des Server-Hostings

# Ihre Server anzeigen
clore servers

# Die Konfiguration eines Servers prüfen
clore server-config "MyGPU"

---

Nächste Schritte

• Python-SDK — Workflows mit Python automatisieren

• REST-API — Roh-API-Dokumentation

• On-Demand vs Spot — Preisgestaltungsmodelle verstehen