First public release of CookTrace, a self-hosted, fully-featured recipe manager for keeping every recipe you cook in one place, with the pantry, cook diary, shopping list, and Android app to match. Inspired by apps like Mealie, built as the third app in the Trace family alongside NutriTrace (nutrition) and LiftTrace (lifting). Single Docker container, AGPL-3.0, no telemetry, no cloud sync, no subscriptions.

Repo: https://github.com/TraceApps/cooktrace Release: https://github.com/... Docker (amd64 + arm64): ghcr.io/traceapps/cooktrace:latest

Recipes

Full recipe model: hero photo, ratings, ingredient groups, step-by-step instructions with per-step photos, kitchen gear, source / video URLs, rich-text notes
Live scaling with snap-to-cooking-fractions math (1 ½ cup not 1.5 cup)
Inline unit converter per ingredient with a built-in 250-entry density table, so volume → grams resolves correctly for flours, oils, dairy, sugars
Cook Mode with screen wake-lock, bigger fonts, persistent checkboxes
FDA-style Nutrition Facts box per recipe (31 nutriments, %DV column)
Cook log — date + notes + photo per cook, full per-recipe history
Sharing — per-user grants, public-link share tokens, Pinterest-style recipe-card image, Kitchens for fanning shares to a whole household

Bring your existing library

If you already keep recipes somewhere, you don't have to start over:

Any recipe URL — three engines: schema.org JSON-LD (fast), recipe-scrapers Python library (300+ site-specific extractors), AI Smart mode for sites that block scrapers
Photo import — snap a cookbook page, the AI assistant extracts the recipe
Mealie / Tandoor / Paprika — paste-import single recipes from JSON, or bulk-import a full-backup zip. Picker shows thumbnails so you can choose exactly which 10 of 200 to bring over
NutriTrace foods → Pantry — search your NT food library and bulk-import as pantry items with nutrition + image

Everything else

Pantry with barcode scanning (ML Kit on Android, QuaggaJS on web), Open Food Facts + USDA lookup, and an "8 / 10 in pantry" match pill on every recipe card
Cook Diary + Meal Planner — list and month-calendar views, drag-to-re-plan, one-tap mark as cooked
Shopping list that pulls missing ingredients from a recipe and skips anything already stocked
Trace AI assistant — bring your own Claude / OpenAI / Gemini key, or point at a local Ollama / LM Studio / LocalAI. Tool use reads + writes your real data; hold-to-record voice for hands-free logging
NutriTrace federation — pull foods from your NT instance, log cooked recipes back to its diary
Android app — runs standalone (fully offline) or connected to the server, with differential sync, biometric sign-in, native barcode scanning
Multi-user — invites, password reset, OIDC SSO (Authentik, Keycloak, Authelia, Pocket-ID, Google)
Backup — scheduled auto-backups, full ZIP restore, portable JSON, Android local-mode .zip for phone-to-phone transfer

First public release — bugs expected

Stable in solo testing for months, but real-world deployment surfaces things one person never will. Bug reports, feature requests, importer-failure URLs, and translation PRs are all genuinely wanted. Use the in-app Diagnostics view (Settings → Diagnostics → View Logs → Share) to attach logs to bug reports.

Issues: https://github.com/TraceApps/cooktrace/issues

Here is what i see as some differences today between CookTrace and Tandoor:

CookTrace:

Pantry is a real first-class catalog, not a tag list. Barcode scanner, Open Food Facts + USDA lookup, per-item stock / serving size / nutrition, plus an "8 / 10 in pantry" match pill on every recipe card. Tandoor has the food list; CookTrace treats it as a primary surface.
AI assistant with tool use — not just a chat bubble. Trace can log a cook, plan a cook, add things to the shopping list, mark a pantry item out of stock, import a recipe URL, etc. by reading and writing your real data
FDA-style Nutrition Facts box auto-computed per recipe from pantry-linked ingredients
Android app with full offline mode (on-device SQLite, differential sync when you reconnect)
NutriTrace federation can import foods from NutriTrace directly into CookTrace's pantry.

Where Tandoor still wins today: PDF / image OCR bulk import, longer track record, larger ecosystem, iCal meal-plan feeds.

Importer's there in CookTrace, so you can move a copy over to compare with zero risk to your existing library whenever the time shows up.