CLI Reference

Search & Discovery

View as Markdown

Search for available instance types across cloud providers, filter by hardware specs, and pipe results directly into brev create.

$brev search [gpu|cpu] [flags]

Aliases: gpu-search, gpu, gpus, gpu-list

The search command has two subcommands:

  • brev search or brev search gpu — GPU instances (default)
  • brev search cpu — CPU-only instances

Search for GPU instance types with filtering by GPU model, VRAM, compute capability, and more.

$brev search [flags]
$brev search gpu [flags]

GPU Flags

FlagShortDescription
--gpu-name-gFilter by GPU name (case-insensitive, partial match)
--provider-pFilter by cloud provider.
--min-vram-vMinimum VRAM per GPU (GB)
--min-total-vram-tMinimum total VRAM across all GPUs (GB)
--min-capability-cMinimum GPU compute capability.
--min-diskMinimum disk size (GB)
--max-boot-timeMaximum boot time (minutes)
--stoppableOnly stoppable instances.
--rebootableOnly rebootable instances.
--flex-portsOnly instances with configurable firewall.
--sort-sSort by: price, gpu-count, vram, total-vram, vcpu, disk, boot-time
--desc-dSort descending.
--jsonOutput as JSON.
--wide-wShow extra columns (RAM, ARCH)

GPU Examples

$# List all available GPUs (sorted by price)
$brev search
$
$# Wide mode with extra columns
$brev search gpu --wide
$
$# Filter by GPU model
$brev search --gpu-name A100
$brev search --gpu-name H100
$
$# Filter by VRAM
$brev search --min-vram 40 --sort price
$
$# Fast-booting GPUs
$brev search --max-boot-time 3 --sort price
$
$# Stoppable instances with minimum VRAM
$brev search --stoppable --min-total-vram 40 --sort price

Search for CPU-only instance types (no GPU).

$brev search cpu [flags]

CPU Flags

FlagShortDescription
--provider-pFilter by cloud provider.
--archFilter by architecture (x86_64, arm64)
--min-ramMinimum RAM in GB.
--min-diskMinimum disk size (GB)
--min-vcpuMinimum number of vCPUs.
--max-boot-timeMaximum boot time (minutes)
--stoppableOnly stoppable instances.
--rebootableOnly rebootable instances.
--flex-portsOnly instances with configurable firewall.
--sort-sSort by: price, vcpu, type, provider, disk, boot-time
--desc-dSort descending.
--jsonOutput as JSON.

CPU Examples

$# All CPU instances
$brev search cpu
$
$# AWS CPU instances
$brev search cpu --provider aws
$
$# High-memory instances
$brev search cpu --min-ram 64 --sort price
$
$# ARM architecture
$brev search cpu --arch arm64
$
$# Many-core instances
$brev search cpu --min-vcpu 16 --sort price
$
$# Pipe to create
$brev search cpu --min-ram 64 | brev create my-cpu-box

Compute Capability Reference

GPU compute capability indicates the architecture generation. Use --min-capability to filter.

CapabilityArchitectureGPUs
7.0VoltaV100
7.5TuringT4, RTX 20xx
8.0AmpereA100, A10, A30
8.6AmpereRTX 30xx, A40
8.9Ada LovelaceL40, RTX 40xx
9.0HopperH100
$# Ampere or newer
$brev search --min-capability 8.0
$
$# Hopper only
$brev search --min-capability 9.0

Output Formats

Table Output (Default)

When run interactively, brev search displays a formatted table:

TYPE            GPU         COUNT  VRAM   TOTAL   $/HR   BOOT  FEATURES
g5.xlarge       A10G        1      24GB   24GB    $1.00  2m    S R P
g5.2xlarge      A10G        1      24GB   24GB    $1.20  2m    S R P
p4d.24xlarge    A100        8      40GB   320GB   $32.77 5m    S R

Features Column

CodeMeaning
SStoppable — can stop/restart without data loss.
RRebootable — can reboot the instance.
PFlex Ports — can modify firewall rules.

JSON Output

Use --json for structured output. Process results with jq:

$brev search --json | jq '.[] | {type, gpu_name, price}'

Piped Output

When stdout is piped to another command, brev search outputs instance type names only (one per line), enabling direct chaining with brev create:

$brev search --gpu-name A100 | brev create my-instance

Common Filter Recipes

Development (Fast and Cheap)

$brev search --max-boot-time 3 --sort price

ML Training (High VRAM)

$brev search --min-vram 40 --sort price

Large Model Training

$brev search --min-total-vram 80 --sort price

Production (Fast and Reliable)

$brev search --gpu-name A100 --max-boot-time 5 --sort price

Budget Conscious

$brev search --min-vram 16 --sort price | head -5

Latest Architecture

$brev search --min-capability 9.0 --sort price