Inicio rápido del SDK de Python

Encuentra una GPU, renuévala y entra por SSH — todo desde Python o la terminal en 5 minutos

Lo que vas a construir: En 5 minutos, buscarás en el mercado de GPU, alquilarás un servidor y te conectarás via SSH — todo desde código o CLI.

Requisitos previos

• Python 3.9+ instalado

• Cuenta de Clore.ai — regístrate aquí

• Clave API — consíguela desde tu panel de Clore.ai

• Fondos — mínimo ~ $5 en BTC, CLORE, USDT o USDC

---

Paso 1: Instala el SDK

pip install clore-ai

Verifica la instalación:

clore --version

---

Paso 2: Configura tu clave API

Opción A: Variable de entorno (recomendada)

export CLORE_API_KEY=tu_clave_api_aqui

Opción B: Configuración por CLI (se guarda en ~/.clore/config.json)

clore config set api_key YOUR_API_KEY

---

Paso 3: Busca una GPU

CLI

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

Verás una tabla con IDs de servidores, especificaciones de GPU, RAM, precio y ubicación.

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"Servidor {s.id}: {s.gpu_count}x {s.gpu_model} — ${s.price_usd:.4f}/h — {s.location}")

Salida:

Servidor 142: 1x NVIDIA GeForce RTX 4090 — $0.0800/h — UE
Servidor 305: 1x NVIDIA GeForce RTX 4090 — $0.0950/h — EE. UU.
Servidor 891: 2x NVIDIA GeForce RTX 4090 — $0.1200/h — UE

Consejo: El marketplace() método filtra del lado del cliente. También puedes filtrar por min_gpu_count, min_ram_gb, y available_only (predeterminado: True).

---

Paso 4: Desplegar (Alquilar un servidor)

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"¡Orden creada! ID: {order.id}")
print(f"IP: {order.pub_cluster}")
print(f"Puertos: {order.tcp_ports}")

El primer arranque tarda entre 1 y 5 minutos. El servidor descarga la imagen Docker y inicia los servicios. Si pub_cluster es None, espera y revisa de nuevo con my_orders().

---

Paso 5: Conectarse via SSH

CLI (conexión automática)

clore ssh 38

La CLI busca la orden, encuentra la IP pública y el puerto SSH, y ejecuta ssh por ti.

SSH manual

ssh root@<pub_cluster> -p <ssh_port>
# Contraseña: MySecurePass123

---

Paso 6: Limpieza

Cuando termines, cancela la orden para detener la facturación:

CLI

clore cancel 38

Python

client.cancel_order(order_id=38, issue="He terminado mi trabajo")
print("Orden cancelada")

---

Script completo: Buscar → Desplegar → Monitorizar → Cancelar

from clore_ai import CloreAI
import time

client = CloreAI()  # Usa la variable de entorno CLORE_API_KEY

# 1. Encontrar la RTX 4090 más barata
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 hay RTX 4090 disponibles por debajo de $5/h")
    exit(1)

best = servers[0]
print(f"Mejor oferta: Servidor {best.id} — ${best.price_usd:.4f}/h — {best.location}")

# 2. Desplegar
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"¡Orden {order.id} creada!")

# 3. Esperar la asignación de 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"¡Listo! SSH: ssh root@{current.pub_cluster} -p {current.tcp_ports.get('22', 22)}")
        break
    print("Esperando a que el servidor inicie...")
    time.sleep(10)

# 4. ... haz tu trabajo ...

# 5. Cancela cuando termines
client.cancel_order(order_id=order.id)
print("Orden cancelada, facturación detenida.")

---

Qué sigue

Guía	Lo que aprenderás
Guía del SDK de Python	Operaciones asíncronas, mercado spot, gestión de servidores, manejo de errores
Automatización con CLI	Scripts Bash, integración CI/CD, despliegue por lotes
Integración de API	Conecta servicios de IA que se ejecutan en Clore con tus aplicaciones
Comparación de GPU	Elige la GPU adecuada para tu carga de trabajo

---

¡Feliz alquiler de GPU! 🚀