truffle

truffle

Find EC2 instance types, compare spot prices, check quotas.

Most commands work without AWS credentials — only truffle quotas and truffle capacity require them.

Installation

macOS / Linux (Homebrew)

brew install spore-host/tap/truffle

Windows (Scoop)

scoop bucket add spore-host https://github.com/spore-host/scoop-bucket
scoop install truffle

Debian / Ubuntu

curl -LO https://github.com/spore-host/truffle/releases/latest/download/truffle_linux_amd64.deb
sudo dpkg -i truffle_linux_amd64.deb

RHEL / Fedora

sudo rpm -i https://github.com/spore-host/truffle/releases/latest/download/truffle_linux_amd64.rpm

Direct download — pre-built binaries for Linux, macOS, and Windows (amd64/arm64) on the releases page.

Build from source

git clone https://github.com/spore-host/truffle
cd truffle && make build && sudo make install

Quick Start

# Search instance types
truffle search "m7i.*"

# Compare spot prices (no credentials needed)
truffle spot c6a.xlarge c7g.xlarge --sort-by-price --active-only

# Find by natural language
truffle find "h200 8gpu efa"
truffle find "amd turin 32 cores 64gb" --exact
truffle find graviton --region us-east-1

# Check EC2 quotas (requires credentials)
truffle quotas --regions us-east-1 --family P

# Check SageMaker quotas
truffle quotas --service sagemaker --family g5 --regions us-west-2

# Find available capacity reservations
truffle capacity --gpu-only

Commands

Go Library

import "github.com/spore-host/truffle/pkg/aws"

client, _ := aws.NewClient(ctx)
results, _ := client.SearchInstanceTypes(ctx, regions, matcher, opts)

// On-demand rate for one type (live AWS Price List, cached)
rate, _ := client.HourlyRate(ctx, "c6i.4xlarge", "us-east-1", "on-demand")

// Spot prices with on-demand comparison populated
prices, _ := client.GetSpotPricing(ctx, results, aws.SpotOptions{ShowSavings: true})

Python Bindings

CGO bindings for Python are available in bindings/python/.

Documentation

Full reference at spore.host/docs.

License

Apache 2.0 — Copyright 2025-2026 Scott Friedman.