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

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.