Repository navigation
v0.1.0 Initial Release
π Pantry Host's first stable release
Pantry Host is a privacy-first kitchen companion for managing recipes, pantry ingredients, cookware, and grocery lists β all running on hardware you control. MIT-licensed, no telemetry, no accounts, no cloud dependencies.
Ships three ways
- Browser-native PWA β a fully offline-capable kitchen powered by PGlite (Postgres compiled to WASM) + IndexedDB. Zero server, zero sign-up.
- Self-hosted β Rex + Postgres stack you run on a Mac Mini, Raspberry Pi, or anything always-on. LAN-shareable; guest mode is read-only, owner actions require
localhostor Tailscale HTTPS. - Marketing site β pantryhost.app
Highlights
Data & interoperability
- Barcode lookup (UPC / EAN) via Open Food Facts
- PLU produce-code lookup via IFPS β type
4011, get bananas - Recipe import from TheMealDB, Cooklang, Wikibooks Cookbook (CC-BY-SA), Public Domain Recipes, TheCocktailDB, and any URL with
schema.org/Recipemarkup - AT Protocol publish + federated feed over
exchange.recipe.*lexicons β "Share to Bluesky" from any recipe/menu, read back viafeed.pantryhost.app's firehose indexer - Docker one-liner for self-host
AI & agents
- AI recipe generation (BYO Anthropic key) that respects on-hand ingredients, cookware, and allergens
- MCP server with 30 tools exposing the GraphQL API to Claude Desktop, Claude Code, IronClaw (Telegram), Cursor, etc. β search, mutate, upload photos (
set_recipe_photo), lookup PLUs, etc.
Presentation
- Responsive image pipeline (WebP + JPEG + grayscale for e-ink) with immutable Service Worker caching
- Featured tag chips with semantic CSS tokens and WCAG AA contrast β
vegan,spring/summer/fall/winter(withautumnsynonym), andcontains-*allergen warnings - Multi-kitchen support, menus/meal-plans, nutrition aggregation, allergen rollups through sub-recipes
- 4 palettes (default, rose, rebecca purple, claude), light/dark/system, and a high-contrast mode
Privacy & distribution
- Guest mode (HTTP on LAN = read-only; localhost / Tailscale HTTPS = owner)
- No telemetry, no accounts, no cloud dependencies
- All data stays on your hardware β export anytime
Getting started
git clone https://github.com/jpdevries/pantry-host.git
cd pantry-host && npm install
cp .env.example .env.local # add DATABASE_URL (+ optional AI_API_KEY)
npm run dev # Rex @ :3000
npm run dev:graphql # GraphQL @ :4001Or try the browser-native version at pantryhost.app β everything runs in-tab, nothing leaves the device.
Thanks
To the early beta testers who reported papercuts and directed prioritization β you shaped this release.
Full Changelog: v0.1.0-beta...v0.1.0