Stars
Forks
Watchers
Developer links
Cooktrace
Every home cook keeps a graveyard of recipes scattered across bookmarks, screenshots, chat threads, and one stained index card, and CookTrace gathers the whole mess into one self-hosted library that knows what is in your pantry. Import recipes from URLs, files, or photos, or bring entire Mealie, Paprika, and Tandoor archives in bulk, then cook with live scaling that does fraction-aware ingredient math, per-step photos, and an inline unit converter. A pantry-match pill on every recipe card tells you at a glance what you can actually cook tonight, while barcode scanning and expiration digests keep stock honest. The cook diary and meal planner move from list to month calendar with drag-to-re-plan, and the shopping list generates itself from planned recipes, skipping items you already own and grouping the rest by aisle. Households organize into cookbooks and shared Kitchens with public links, and an optional conversational assistant can log a cook, plan a meal, or import a recipe for you. An opt-in MCP server even exposes your recipes and lists to external AI agents under token-scoped tool tiers. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. AGPL-3.0 licensed.
Benefits
- Cook from your pantry
- Every recipe card carries a pantry-match pill showing whether your current stock covers it, and barcode scanning with Open Food Facts and USDA signals keeps the pantry accurate without typing.
- Imports from anywhere painless
- Paste a recipe URL, file, or photo, or bulk-import whole Mealie, Paprika, and Tandoor zip archives, with tiered extraction that fills ingredients, steps, timings, and nutrition automatically.
- Shopping lists build themselves
- Generate a list from planned recipes and CookTrace skips items already in your pantry, deduplicates across recipes, and groups what remains by supermarket aisle for one clean pass through the store.
- Private by architecture
- One Docker container on your hardware with no accounts on external services, no trackers, and no telemetry; data leaves your network only when you opt into an integration yourself.
Features
- Recipe library, cook mode
- Full recipe model with cook mode, cook log, live scaling using fraction-aware ingredient math, per-step photos, inline unit conversion, and an FDA-style 34-nutriment Nutrition Facts box.
- Pantry and cook diary
- Pantry variants, expiration digests, and barcode scanning via ML Kit or QuaggaJS, beside a cook diary and meal planner with month-calendar view and drag-to-re-plan.
- Cookbooks and Kitchens
- Named cookbook collections with per-user and public-link sharing, plus Kitchens for household-wide fanout with Auto-Share, categories, tags, gear, and unit catalogs you manage.
- AI assistant and MCP
- Optional Trace AI with 19 conversational tools across Claude, OpenAI, Gemini, or any OpenAI-compatible endpoint, plus an opt-in MCP Streamable HTTP server with token-scoped tool tiers.
- SSO, backups, everywhere
- Multi-user accounts with OIDC single sign-on for Authentik, Keycloak, Authelia, and more, scheduled full-database zip backups, and clients for browser PWA, Android, and Wear OS.