Skip to content

v0.1.0 Initial Release

Choose a tag to compare

@jpdevries jpdevries released this 20 Apr 04:39
· 108 commits to main since this 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 localhost or 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/Recipe markup
  • AT Protocol publish + federated feed over exchange.recipe.* lexicons β€” "Share to Bluesky" from any recipe/menu, read back via feed.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 (with autumn synonym), and contains-* 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 @ :4001

Or 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