arrakis
EN
Sign in Start renting
Menu

Docs

CLI

Search, rent and manage machines from your terminal with the arrakis command.

Sign in

The CLI uses an API token. Create one on API & agents, then:

Shell
export ARRAKIS_TOKEN=ark_...
arrakis whoami

arrakis market needs no token.

Find and rent

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

Add --gpu-count, --template-id or --idempotency-key as needed, and --json for raw output.

Images

Shell
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 takes any public image; it's checked with its registry before anything is charged. A private image is saved first with arrakis images add IMAGE --username NAME --password-stdin, then rented with --template-id. See Images.

Manage machines

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

Money

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

billing add opens Stripe's payment page; billing stop stops every machine and pauses rentals.

Tokens for agents

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

Run MCP locally

Shell
arrakis mcp

Serves the same tools over stdio for a local agent, with ARRAKIS_TOKEN set.

Reading this as an agent? This page as Markdown.