Managed Compute with the CLI

The orx CLI can browse OpenResearch compute and manage standalone GPU or CPU instances without opening the web dashboard.

Install and sign in

These commands need the orx CLI. The macOS app runs the dashboard but doesn't put orx on your PATH, so install the CLI below either way.

curl -LsSf https://openresearch.sh/install.sh | sh
orx login
orx ssh-key add

orx login connects the CLI to your OpenResearch account. The SSH key command registers ~/.ssh/id_ed25519.pub by default so instances accept connections from this computer. Use orx ssh-key list to check registered keys.

Browse offers

# GPU offers
orx compute
orx compute --gpu H100_SXM --count 1

# CPU offers
orx compute --cpu

GPU identifiers are exact values from the GPU column. Filter further with --provider when you need a specific provider.

Create an instance

Copy your organization ID from the /orgs/<orgId>/compute URL. Omit --provider to select the cheapest matching GPU offer across providers.

# Hosted GPU
orx instance create <orgId> --gpu H100_SXM --count 1 --disk 100

# Hosted CPU
orx instance create <orgId> --cpu cpu5c --vcpus 8

List and terminate instances

orx instance list <orgId>
orx instance delete <instanceId>

Terminating an instance destroys the provider machine. Copy anything you need before deleting it.

Use OpenResearch from the local dashboard

Run orx up, then open Settings > Compute > OpenResearch to check your login, organization, and SSH key status or make OpenResearch your default compute target.