> For the complete documentation index, see [llms.txt](https://docs.clore.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clore.ai/clore.ai/clore.ai-eng-es/desarrolladores/cli-guide.md).

# Referencia de la CLI

La `clore` La CLI te permite administrar el mercado de GPU de Clore.ai directamente desde tu terminal: busca GPU, despliega instancias, accede por SSH y gestiona pedidos sin escribir código.

***

## Instalación

```bash
pip install clore-ai
```

Esto instala tanto el SDK de Python como el `clore` comando de la CLI.

**Requisitos:** Python 3.9+

***

## Configuración

### Configura tu clave API

Obtén tu clave desde el [panel de control de Clore.ai](https://clore.ai) → **API** sección API, luego configura:

```bash
clore config set api_key YOUR_API_KEY
```

Esto guarda la clave en `~/.clore/config.json`.

### O usa una variable de entorno

```bash
export CLORE_API_KEY=your_api_key_here
```

### Ver la configuración actual

```bash
# Mostrar toda la configuración
clore config show

# Obtener un valor específico
clore config get api_key
```

***

## Comandos

| Comando                               | Descripción                                  |
| ------------------------------------- | -------------------------------------------- |
| `clore search`                        | Buscar en el mercado de GPU                  |
| `clore deploy <server_id>`            | Crear un nuevo pedido (alquilar un servidor) |
| `clore orders`                        | Lista tus pedidos                            |
| `clore cancel <order_id>`             | Cancelar un pedido                           |
| `clore ssh <order_id>`                | Acceder por SSH a un pedido activo           |
| `clore wallets`                       | Mostrar saldos de las carteras               |
| `clore servers`                       | Lista tus servidores alojados                |
| `clore server-config <name>`          | Obtener la configuración del servidor        |
| `clore spot <server_id>`              | Ver el mercado spot de un servidor           |
| `clore spot-price <order_id> <price>` | Establecer el precio spot                    |
| `clore config set <key> <value>`      | Establecer un valor de configuración         |
| `clore config get <key>`              | Obtener un valor de configuración            |
| `clore config show`                   | Mostrar toda la configuración                |
| `clore --version`                     | Mostrar versión                              |

***

## Uso detallado

### `clore search`

Busca en el mercado de GPU con filtros y ordenación.

```bash
# Lista todos los servidores disponibles (ordenados por precio, top 20)
clore search

# Filtrar por modelo de GPU
clore search --gpu "RTX 4090"

# Filtrar por GPU y precio máximo
clore search --gpu "RTX 4090" --max-price 5.0

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

# Ordenar por cantidad de GPU, mostrar los 10 primeros
clore search --sort gpu --limit 10

# Combinar filtros
clore search --gpu "A100" --min-ram 128 --max-price 10.0 --sort price --limit 5
```

**Opciones:**

| Opción        | Tipo    | Descripción                                         |
| ------------- | ------- | --------------------------------------------------- |
| `--gpu`       | texto   | Filtrar por modelo de GPU (p. ej. `"RTX 4090"`)     |
| `--min-gpu`   | entero  | Cantidad mínima de GPU                              |
| `--min-ram`   | decimal | Cantidad mínima de RAM en GB                        |
| `--max-price` | decimal | Precio máximo en USD/hora                           |
| `--sort`      | opción  | Ordenar por: `price` (predeterminado), `gpu`, `ram` |
| `--limit`     | entero  | Máximo de resultados a mostrar (predeterminado: 20) |

**Ejemplo de salida:**

```
🔍 Mercado de GPU
┏━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ID  ┃ GPU                             ┃ Cantidad ┃ RAM (GB) ┃ CPU                          ┃ Precio/h (USD) ┃ Ubicación ┃
┡━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ 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       │
└─────┴─────────────────────────────────┴───────┴──────────┴──────────────────────────────┴───────────────┴──────────┘
Mostrando 2 servidores
```

***

### `clore deploy <server_id>`

Crea un nuevo pedido para alquilar un servidor GPU.

```bash
# Pedido bajo demanda con SSH
clore deploy 123 \\
  --image cloreai/ubuntu22.04-cuda12 \\
  --type on-demand \\
  --currency bitcoin \\
  --ssh-password MySecurePass123 \\
  --port 22:tcp \\
  --port 8888:http

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

# Con variables de entorno
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
```

**Argumentos:**

| Argumento   | Descripción                                            |
| ----------- | ------------------------------------------------------ |
| `server_id` | ID del servidor a alquilar (obténlo de `clore search`) |

**Opciones:**

| Opción           | Tipo    | Requerido | Descripción                                                                                      |
| ---------------- | ------- | --------- | ------------------------------------------------------------------------------------------------ |
| `--image`        | texto   | Sí        | Imagen de Docker (p. ej. `cloreai/ubuntu22.04-cuda12`)                                           |
| `--type`         | opción  | Sí        | `on-demand` o `spot`                                                                             |
| `--currency`     | texto   | Sí        | Moneda de pago (p. ej. `bitcoin`)                                                                |
| `--ssh-password` | texto   | No        | Contraseña SSH (alfanumérica, máximo 32 caracteres)                                              |
| `--ssh-key`      | texto   | No        | Clave pública SSH                                                                                |
| `--port`         | texto   | No        | Mapeo de puertos (repetible), formato: `PORT:PROTOCOL`                                           |
| `--env`          | texto   | No        | Variable de entorno (repetible), formato: `KEY=VALUE`                                            |
| `--spot-price`   | decimal | No        | Precio spot por día (requerido para pedidos spot)                                                |
| `--gpu-count`    | entero  | No        | Alquila solo N GPU (alquiler parcial, solo bajo demanda)                                         |
| `--gpu-indices`  | texto   | No        | Ranuras de GPU separadas por comas de `partial_gpu_rental.free_indices` (requiere `--gpu-count`) |

***

### `clore orders`

Lista tus pedidos activos.

```bash
# Pedidos activos
clore orders

# Incluir pedidos completados/expirados
clore orders --completed
```

**Opciones:**

| Opción        | Descripción                           |
| ------------- | ------------------------------------- |
| `--completed` | Incluir pedidos completados/expirados |

**Ejemplo de salida:**

```
📦 Mis pedidos
┏━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID ┃ Server ID ┃ Tipo      ┃ Estado ┃ Imagen                            ┃ IP                      ┃
┡━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 38 │ 6         │ on-demand │ Activo │ cloreai/ubuntu22.04-cuda12        │ n1.c1.clorecloud.net    │
└────┴───────────┴───────────┴────────┴───────────────────────────────────┴─────────────────────────┘
Total: 1 pedido
```

***

### `clore cancel <order_id>`

Cancela un pedido activo.

```bash
# Cancelar pedido
clore cancel 38

# Cancelar con informe de incidencia
clore cancel 38 --issue "GPU was overheating"
```

**Argumentos:**

| Argumento  | Descripción              |
| ---------- | ------------------------ |
| `order_id` | ID del pedido a cancelar |

**Opciones:**

| Opción    | Descripción                                   |
| --------- | --------------------------------------------- |
| `--issue` | Motivo de cancelación / informe de incidencia |

***

### `clore ssh <order_id>`

Conexión automática por SSH a un pedido en ejecución. La CLI resuelve el nombre de host y el puerto a partir de los detalles de tu pedido.

```bash
# Conectarse como root (predeterminado)
clore ssh 38

# Conectarse como un usuario diferente
clore ssh 38 --user ubuntu
```

**Argumentos:**

| Argumento  | Descripción                     |
| ---------- | ------------------------------- |
| `order_id` | ID del pedido al que conectarse |

**Opciones:**

| Opción   | Predeterminado | Descripción           |
| -------- | -------------- | --------------------- |
| `--user` | `root`         | Nombre de usuario SSH |

***

### `clore wallets`

Muestra los saldos de tus carteras y las direcciones de depósito.

```bash
clore wallets
```

**Ejemplo de salida:**

```
💰 Saldos de las carteras
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Moneda          ┃ Saldo        ┃ Dirección de depósito                     ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ bitcoin          │ 0.00153176   │ tb1q6erw7v02t7hakgmlcl4wfnlykzqj05alndruwr │
│ CLORE-Blockchain │ 150.00000000 │ cLr1q8x...                                │
└──────────────────┴──────────────┴───────────────────────────────────────────┘
```

***

### `clore servers`

Lista los servidores que estás alojando en el mercado.

```bash
clore servers
```

***

### `clore server-config <name>`

Obtén la configuración de un servidor específico que alojas.

```bash
clore server-config "MyGPU"
```

**Ejemplo de salida:**

```
Servidor: MyGPU
ID: 42
Conectado: True
En línea: True
Visibilidad: public
Duración máxima del alquiler: 72
GPU: NVIDIA GeForce RTX 4090
Precio bajo demanda (USD): $0.35
Precio 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>`

Ver las ofertas actuales del mercado spot para un servidor.

```bash
clore spot 6
```

**Ejemplo de salida:**

```
📊 Mercado spot - Servidor 6
┏━━━━━━━━━━┳━━━━━━━━━━━┓
┃ ID del pedido ┃ Precio     ┃
┡━━━━━━━━━━╇━━━━━━━━━━━┩
│ 39       │ 4.2e-06   │
└──────────┴───────────┘
```

***

### `clore spot-price <order_id> <price>`

Actualiza el precio de tu oferta en el mercado spot.

```bash
clore spot-price 39 0.000003
```

> **Nota:** Solo puedes bajar los precios spot una vez cada 600 segundos y en un tamaño de paso limitado.

***

### `clore config`

Gestiona la configuración de la CLI.

```bash
# Establecer clave API
clore config set api_key YOUR_API_KEY

# Obtener un valor
clore config get api_key

# Mostrar toda la configuración
clore config show
```

La configuración se guarda en `~/.clore/config.json`.

***

## Flujos de trabajo

### Buscar → Alquilar → SSH → Cancelar

Un flujo de trabajo típico de extremo a extremo:

```bash
# 1. Encuentra una RTX 4090 por menos de $5/hora
clore search --gpu "RTX 4090" --max-price 5.0 --sort price --limit 5

# 2. Despliega en el servidor más barato (p. ej. 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. Comprueba el estado de tu pedido
clore orders

# 4. Conéctate por SSH a la instancia (p. ej. ID de pedido 456)
clore ssh 456

# 5. Cuando termines, cancela el pedido
clore cancel 456
```

### Monitoriza los saldos antes de alquilar

```bash
# Comprueba que tienes fondos suficientes
clore wallets

# Buscar y alquilar
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
```

### Flujo de trabajo del mercado spot

```bash
# 1. Comprueba las ofertas spot para un servidor
clore spot 6

# 2. Crea un pedido spot
clore deploy 6 \\
  --image cloreai/pytorch \\
  --type spot \\
  --currency bitcoin \\
  --spot-price 0.000005 \\
  --ssh-password MyPass123 \\
  --port 22:tcp

# 3. Ajusta tu precio spot
clore spot-price 39 0.000003
```

### Gestión del alojamiento de servidores

```bash
# Ver tus servidores
clore servers

# Comprueba la configuración de un servidor
clore server-config "MyGPU"
```

***

## Próximos pasos

* [**SDK de Python**](/clore.ai/clore.ai-eng-es/desarrolladores/python-sdk.md) — Automatiza flujos de trabajo con Python
* [**API REST**](/clore.ai/clore.ai-eng-es/para-hosts/api.md) — Documentación sin procesar de la API
* [**Bajo demanda vs spot**](/clore.ai/clore.ai-eng-es/para-arrendatarios/on-demand-vs-spot.md) — Comprende los modelos de precios


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-es/desarrolladores/cli-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.