Anor CLI Documentation

GPU compute with SSH access. Buy time, get a shell.

Installation

pip install anor

Requires Python 3.8+.

Authentication

Login with your browser (supports Google OAuth):

anor login

Or use email/password directly:

anor login --no-browser -e your@email.com

You can also use an API key:

anor login --api-key YOUR_API_KEY

Instances API

The Instances API lets you create, manage, and terminate GPU instances programmatically. All endpoints require a Bearer token via the Authorization header.

Base URL: https://anorcloud.com/api/v1/instances

List Instances

Returns all running instances for your account.

curl -X GET "https://anorcloud.com/api/v1/instances" \
  -H "Authorization: Bearer $ANOR_TOKEN"

Create Instance (one-step)

Creates and launches an instance in a single request.

curl -X POST "https://anorcloud.com/api/v1/instances" \
  -H "Authorization: Bearer $ANOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "gpuType": "A100",
    "gpuCount": 1,
    "durationMinutes": 60,
    "region": "us-east-1"
  }'

Two-Step Flow: Request then Launch

For more control, create a pending request first, then launch it later (e.g., to select a specific node).

Step 1: Request

curl -X POST "https://anorcloud.com/api/v1/instances/request" \
  -H "Authorization: Bearer $ANOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"gpuType": "H100", "durationMinutes": 120}'

Step 2: Launch (use id from request response)

curl -X POST "https://anorcloud.com/api/v1/instances/<requestId>/launch" \
  -H "Authorization: Bearer $ANOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"region": "us-east-1"}'

Get Instance

curl -X GET "https://anorcloud.com/api/v1/instances/<vmId>" \
  -H "Authorization: Bearer $ANOR_TOKEN"

Terminate Instance

curl -X DELETE "https://anorcloud.com/api/v1/instances/<vmId>" \
  -H "Authorization: Bearer $ANOR_TOKEN"

List Requests

List all instance requests (including pending ones).

curl -X GET "https://anorcloud.com/api/v1/instances/requests/list" \
  -H "Authorization: Bearer $ANOR_TOKEN"

Cancel Request

Cancel a pending request before it is launched.

curl -X DELETE "https://anorcloud.com/api/v1/instances/requests/<requestId>" \
  -H "Authorization: Bearer $ANOR_TOKEN"

Request Body Parameters

FieldTypeDescription
gpuTypestringGPU type (e.g., A100, H100)
gpuCountnumberNumber of GPUs (default: 1)
durationMinutesnumberDuration in minutes (required)
regionstringRegion to launch in (optional)
nodeIdstringSpecific node ID (optional, overrides region)
memorynumberMemory in bytes (optional)
storagenumberStorage in bytes (optional)

Buy GPU Compute

Buy GPU time and get SSH access:

anor buy --gpu T4 --duration 3

After purchase, you'll be prompted to SSH directly or view connection details.

Options

FlagDescription
--gpu, -gGPU type: T4, A100, H100, etc. (required)
--duration, -dDuration in hours (required)
--quantity, -qNumber of GPUs (default: 1)
--marketMarket order (default) - fills when available
--limitLimit order - expires if not filled by deadline
--expires-atExpiration for limit orders (YYYY-MM-DDTHH:MM)

Examples

# Multiple GPUs
anor buy --gpu A100 --duration 24 --quantity 2
# Limit order with expiration
anor buy --gpu H100 --duration 1 --limit --expires-at 2024-12-31T23:59

Managing VMs

Check your active VMs:

anor status

SSH into your most recent VM:

anor ssh

SSH into a specific VM:

anor ssh <vm-id>

Available GPUs

View available GPUs and current pricing:

anor gpus
GPUStarting Price
T4$0.50/hr
L4$0.80/hr
A100$2.00/hr
H100$3.50/hr

Prices vary based on availability. Run anor gpus for real-time pricing.

Other Commands

Check your balance:

anor balance

Show current user:

anor whoami

Logout:

anor logout

Environment Variables

VariableDescription
ANOR_API_URLOverride the API URL (default: https://anorcloud.com)
ANOR_API_KEYUse API key instead of stored credentials

Back to home