# CLI

Busque, alugue e gerencie máquinas pelo terminal com o comando arrakis.

> O comando `arrakis` abre ao público em breve. Tudo o que ele faz também funciona no console, via MCP e pela API.

## Entrar

A CLI usa um token de API. Crie um em **API & agents** e depois:

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

`arrakis market` não precisa de token.

## Encontre e alugue

```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
```

Adicione `--gpu-count`, `--template-id` ou `--idempotency-key` conforme a necessidade, e `--json` para a saída bruta.

## Imagens

```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` aceita qualquer imagem pública; ela é verificada no registro antes de qualquer cobrança. Uma imagem privada primeiro é salva com `arrakis images add IMAGE --username NAME --password-stdin` e depois alugada com `--template-id`. Veja [Imagens](/pt/docs/images).

## Gerencie máquinas

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

## Dinheiro

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

`billing add` abre a página de pagamento do Stripe; `billing stop` desliga todas as máquinas e pausa os aluguéis.

## Tokens para agentes

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

## Rode o MCP localmente

```sh
arrakis mcp
```

Oferece as mesmas ferramentas via stdio para um agente local, com `ARRAKIS_TOKEN` definido.

Mais: [toda a documentação](/pt/docs.md) · [OpenAPI](/openapi.json) · [llms.txt](/pt/llms.txt)