v0.2.0

All-You-Can-Eat
LLM Provider
Buffet for Agents

An interactive terminal CLI that health-checks 165 LLM providers, seals your API keys in an AES-256-GCM vault, and auto-generates working configs for OpenCode, Codex CLI, Claude Code, and Antigravity in one sitting.

$npx freebuffet

See a Session View GitHub Repo

Buffet Counters

165Providers on the Menu

99Permanent Free Tiers

47No-Credit-Card Needed

19Local Engines ($0)

Verified against src/providers.ts, v0.2.0

From One Sitting to Four Agents

One session, four agent configs. Every snippet below is the exact format FreeBuffet writes to disk.

terminal, npx freebuffet

$ npx freebuffet

  ┌  FreeBuffet v0.2.0, 165 providers on the menu
  │
  ├  Step 1   Select providers
  │    │  ▸ ◯ Groq          free, 30 RPM, no CC
  │    │    ◯ Cerebras      free, 1M tok/day, no CC
  │    │    ◯ Google Gemini free, 1,500 RPD, no CC
  │    │    ◯ Ollama        local, $0, no key
  │    │  ▸ type to filter 165 entries…
  │    ▼
  ├  Step 2   Enter API keys
  │    │    GROQ_API_KEY = gsk_•••••••••••••••
  │    │    CEREBRAS_API_KEY = csk-••••••••••••
  │    │    (local engines auto-skipped)
  │    ▼
  ├  Step 3   Health check
  │    │    ✓ groq        ok, 214ms, 18 models
  │    │    ✓ cerebras    ok, 359ms, 11 models
  │    │    ✓ gemini      ok, 487ms, 42 models
  │    │    ✓ ollama      ok, 3ms, 4 models
  │    ▼
  ├  Step 4   Select target agents
  │    │    ✓ OpenCode  ✓ Codex CLI
  │    │    ✓ Claude Code  ◯ Antigravity
  │    ▼
  └  Step 5   Configs generated
       │    ./opencode.json                    written
       │    ~/.local/share/opencode/auth.json  written
       │    ~/.codex/config.toml               written
       │    ~/.claude/settings.json            written
       │
       └  Keys sealed in ~/.config/freebuffet/config.enc (AES-256-GCM)

The Menu

Every capability between npx and a working agent config. Search by keyword, filter by course.

find$

course

REGISTRY165 ENTRIES / TYPED

The 165-Provider Menu

A hand-curated registry with baseURLs, env keys, free-tier quotas, and API types. Groq, Cerebras, Gemini, OpenRouter, Ollama. Every entry searchable by name or id, filterable by tag.

src/providers.ts

cost-sorted, tag-filtered

ON THE MENU165

HEALTHFETCH / LATENCY / MODELS

Zero-Config Health Checks

Pings /v1/models or /v1/messages per provider, measures latency, and discovers the live model list before a single config is written. Unhealthy providers never make it to your agent.

src/health.ts

status, latency, model list

SIGNALS3

SECURITYSCRYPT / AES-256-GCM

Encrypted Key Vault

API keys are sealed in ~/.config/freebuffet/config.enc with a machine-bound scrypt key. No plaintext, no cloud, no telemetry. Keys never leave your box.

src/config.ts

12-byte IV, 16-byte GCM tag

KEY LENGTH256-BIT

AGENTSJSON / TOML / SHELL

Four Agent Targets, One Run

Generates opencode.json, ~/.codex/config.toml, and ~/.claude/settings.json, plus experimental Antigravity support, from a single provider selection. Existing files are backed up, never clobbered.

src/configs/

health-gated, backup-first

AGENT TARGETS4

LOCALOLLAMA / VLLM / LLAMA.CPP

19 Local Engines

Zero-cost local inference: Ollama, LM Studio, llama.cpp, vLLM, SGLang, and 14 more. Key prompts auto-skipped.

README § Local & Self-Hosted

no env key required

PRICE$0

WELFARE10 SITES / LIVE PROBES

Free Credit Relay Registry

A registry of public-welfare relay stations handing out free Claude and GPT credits. Think $50 to $100 signup bonuses, daily check-ins, and invite stacking. FreeBuffet probes their live status and calculates your first-day total.

data/welfare-sites.json

signup + invite + daily math

RELAY STATIONS10

REGISTRYTAGGED / RANKED

25 Curated Free-Coding Favorites

The editor's picks with capability tags for coding, reasoning, vision, fast, free, and no-cc, so you pick a provider in seconds instead of settings tabs.

CURATED_FAVORITES

coding, reasoning, vision, free, fast, no-cc

OF 165 PICKED25

UX@CLACK / PICOOLORS

Searchable Terminal TUI

Type-to-filter provider checklist, live health-check spinners, config preview before write. Runs on Node 18+ and Bun with one runtime dep (picocolors) and zero native modules.

src/index.ts

node 18+, bun 1.0+

RUNTIME DEPS1

The Free-Tier Ledger

Quotas transcribed from the freeTier field of src/providers.ts. No credit card needed for any of these.

Provider	Free Tier	Rate Limits	Credit Card	Notes
GroqLEADING	Permanent free	30 RPM, 14,400 RPD	None	LPU, fastest
Cerebras	Permanent free	1M tokens/day	None	2600 tok/s
Google Gemini	Permanent free	1,500 RPD (Flash)	None	1M-token context
Mistral AI	Permanent free	1B tokens/month	None	Codestral included
GitHub Models	Permanent free	50 to 150 RPD	GitHub account	GPT-4o, Claude, Gemini
Hugging Face	Permanent free	100K credits/month	None	100K+ open models
Ollama (local)	Unlimited	Your hardware	None	about 3ms, offline

METHODOLOGY // quotas transcribed verbatim from the freeTier field of src/providers.ts●Registry Verified

Under the Hood

Where the code lives. About 5,000 lines of TypeScript, no native deps, and a clear pattern for adding providers.

LAYER 0

Provider Registry

165 typed entries in src/providers.ts, each with an id, baseURL, env key, API type, free tier, and tags. Query helpers handle search, cost sorting, and tag filtering.

LAYER 1

Health Check

src/health.ts probes each provider at /v1/models or /v1/messages and returns the status, the latency in milliseconds, and the list of models it found. Bad keys are separated from bad providers.

LAYER 2

Encrypted Key Store

src/config.ts seals your keys with AES-256-GCM under a scrypt key derived from your home directory, hostname, and platform. The vault at ~/.config/freebuffet/config.enc only opens on the machine that wrote it.

LAYER 3

Config Generators

src/configs/ turns healthy providers into real files: opencode.json and auth.json for OpenCode, config.toml for Codex, settings.json and env.sh for Claude Code, plus experimental Antigravity entries. Anything that exists already gets a timestamped backup first.

LAYER 4

Welfare Registry

src/welfare.ts tracks ten free-credit relay stations from data/welfare-sites.json. It adds up signup, invite, and daily check-in credits into a first-day total, probes live status, and merges snapshots when a site is behind Cloudflare.

Contribute to the Menu

All development happens publicly on GitHub. Adding a provider is one typed object in src/providers.ts, and the health check, config generators, and TUI all follow the same pattern. Run bun run dev to try your changes locally.

Contribution Guide Read the README

Open Dispatches (Roadmap)

Publish freebuffet@0.2.0 to the npm registry

RELEASEcomponent: package.json

Per-provider model count display during health check

ROADMAPcomponent: src/health.ts

Add a "refresh config" command to re-fetch models

ROADMAPcomponent: src/configs/

More providers as new free/cheap services emerge

ROADMAPcomponent: src/providers.ts

SUPPORT

Keep the Buffet Open

FreeBuffet is MIT-licensed and built in the open. If it saved you an afternoon of config wrangling, star the repo or pass the menu along to another engineer. Sponsor details are coming soon.

6yte96/freebuffet

@6yte96·MIT License·2026 EDITION

LICENSEMIT

Star on GitHubSponsor

All-You-Can-EatLLM ProviderBuffet for Agents