> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nodepick.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Compute Discovery (np compute)

> Discover available compute hosts, hardware capacity, and real-time hourly and monthly pricing.

Search and discover available bare metal compute hosts matching specific hardware specifications, regions, and pricing limits.

## Syntax

```bash theme={null}
np compute [options]
```

## Options

| Option | Short | Description | Default |
| - | - | - | - |
| `--cpu` | `-c` | Minimum CPU cores required | `1` |
| `--memory` | `-m` | Minimum RAM in gigabytes (GB) | `1` |
| `--storage` | `-s` | Minimum disk storage in gigabytes (GB) | `10` |
| `--max-price` | `-p` | Maximum monthly budget in USD | None |
| `--region` | `-r` | Filter by target region (e.g. `us-west-1`, `fmt1`) | None |
| `--datacenter` | | Filter by datacenter facility code (e.g. `fmt1`) | None |
| `--status` | | Filter by host status: `active`, `reservable`, `all` | `all` (shows active and reservable) |
| `--format` | `-f` | Output format (`table` or `json`) | `table` |

## Output Columns

The table output shows the full compute **Host ID**, lifecycle status, location, and the consolidated **requested slice specifications** (RAM/Disk/CPU) evaluated for pricing:

| Column | Description |
| - | - |
| `Host ID` | Full, untruncated UUID of the compute host |
| `Status` | Lifecycle status: `active` (deployable immediately) or `reservable` |
| `Region` | Geographic region of the host |
| `Datacenter` | Specific facility code |
| `RAM/Disk/CPU` | Consolidated requested slice specs: RAM (GB) / Disk (GB) / CPU (Cores) (e.g. `1/10/5`) |
| `Price/hr ($)` | Estimated hourly USD rate |
| `Price/mo ($)` | Estimated monthly USD rate (\~730 hours/month) |

<Note>
  The `RAM/Disk/CPU` column reflects the requested resources corresponding to the slice price (e.g. `1/10/5` indicates 1 GB RAM, 10 GB Disk, 5 CPU cores), not the total bare metal capacity of the underlying host server. To view total host hardware capacity, use `--format json`.
</Note>

## Examples

<CodeGroup>
  ```bash Default Search theme={null}
  # Discover active and reservable hosts with baseline slice specs (1 vCPU, 1 GB RAM, 10 GB Disk)
  np compute
  ```

  ```bash Custom Hardware Requirements theme={null}
  # Discover hosts with at least 4 vCPUs, 8 GB RAM, and 50 GB storage
  np compute -c 4 -m 8 -s 50
  ```

  ```bash Budget Filter theme={null}
  # Filter for hosts with a monthly rate of $20 or less in us-west-1
  np compute -c 2 -m 4 -s 20 -p 20 -r us-west-1
  ```

  ```bash JSON Output theme={null}
  # Output machine-readable JSON for scripting
  np compute -c 2 -m 4 -f json
  ```
</CodeGroup>

## Related Commands

<CardGroup cols={2}>
  <Card title="Create Node" icon="plus" href="/cli-reference/nodes/create">
    Deploy a new compute node onto discovered compute hosts.
  </Card>

  <Card title="List Nodes" icon="list" href="/cli-reference/nodes/list">
    View all active compute nodes.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.