# CLI

Cherchez, louez et gérez vos machines depuis votre terminal avec la commande arrakis.

> La commande `arrakis` sera bientôt ouverte au public. Tout ce qu’elle fait fonctionne aussi dans la console, via MCP et via l’API.

## Se connecter

La CLI utilise un jeton d’API. Créez-en un dans **API & agents**, puis :

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

`arrakis market` ne nécessite aucun jeton.

## Trouver et louer

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

Ajoutez `--gpu-count`, `--template-id` ou `--idempotency-key` selon vos besoins, et `--json` pour une sortie brute.

## Images

```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` accepte n’importe quelle image publique ; elle est vérifiée auprès de son registre avant tout débit. Une image privée est d’abord enregistrée avec `arrakis images add IMAGE --username NAME --password-stdin`, puis louée avec `--template-id`. Voir [Images](/fr/docs/images).

## Gérer les machines

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

## Argent

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

`billing add` ouvre la page de paiement de Stripe ; `billing stop` arrête toutes les machines et suspend les locations.

## Jetons pour les agents

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

## Lancer MCP en local

```sh
arrakis mcp
```

Expose les mêmes outils via stdio pour un agent local, avec `ARRAKIS_TOKEN` défini.

Plus : [toute la documentation](/fr/docs.md) · [OpenAPI](/openapi.json) · [llms.txt](/fr/llms.txt)