# CLI

Busca, alquila y gestiona máquinas desde tu terminal con el comando arrakis.

> El comando `arrakis` se abrirá pronto al público. Todo lo que hace también funciona en la consola, por MCP y a través de la API.

## Iniciar sesión

La CLI usa un token de API. Crea uno en **API & agents** y luego:

```sh
export ARRAKIS_TOKEN=ark_...
arrakis whoami
```

`arrakis market` no necesita token.

## Buscar y alquilar

```sh
arrakis market
arrakis gpus search --gpu-type B200
arrakis instances create --node-id <node> --termination-hours 4 --ssh-public-key ~/.ssh/id_ed25519.pub
```

Añade `--gpu-count`, `--template-id` o `--idempotency-key` según necesites, y `--json` para obtener la salida sin procesar.

## Imágenes

```sh
arrakis images list
arrakis images add vllm/vllm-openai:v0.11.0 --start image
arrakis instances create --node-id <node> --image vllm/vllm-openai:v0.11.0 --start image --termination-hours 2
```

`--image` acepta cualquier imagen pública; se comprueba con su registro antes de cobrar nada. Una imagen privada se guarda primero con `arrakis images add IMAGE --username NAME --password-stdin` y luego se alquila con `--template-id`. Consulta [Imágenes](/es/docs/images).

## Gestionar máquinas

```sh
arrakis instances list
arrakis instances get <id>
arrakis instances schedule-removal <id> --in 3h
arrakis instances terminate <id>
```

## Dinero

```sh
arrakis billing status
arrakis billing add 50
arrakis billing auto-recharge --on --threshold 20 --amount 50
arrakis billing stop
```

`billing add` abre la página de pago de Stripe; `billing stop` detiene todas las máquinas y pausa los alquileres.

## Tokens para agentes

```sh
arrakis tokens create --name eval-agent --scope read --scope rent --spend-limit 50 --max-rental-hours 6
```

## Ejecutar MCP en local

```sh
arrakis mcp
```

Ofrece las mismas herramientas por stdio a un agente local, con `ARRAKIS_TOKEN` definida.

Más: [toda la documentación](/es/docs.md) · [OpenAPI](/openapi.json) · [llms.txt](/es/llms.txt)