explaingit

tandoorrecipes/recipes

8,325HTMLAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

Tandoor Recipes is a self-hosted web app for organizing your personal recipe collection, planning weekly meals, and auto-generating shopping lists, with import from thousands of cooking websites.

Mindmap

mindmap
  root((Tandoor Recipes))
    What it does
      Recipe collection
      Meal planning
      Shopping lists
    Tech Stack
      Python backend
      Docker
      HTML frontend
    Use Cases
      Import from websites
      Family sharing
      Nutrition from images
    Self-hosting
      Docker setup
      Nextcloud sync
      Multi-user access
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Import recipes from any cooking website by pasting a link and build a searchable personal collection with fuzzy search.

USE CASE 2

Plan your weekly meals and automatically generate a consolidated shopping list from selected recipes.

USE CASE 3

Share your recipe collection with family members using built-in multi-user access controls on your own server.

USE CASE 4

Scale any recipe up or down for different serving sizes and bulk-rename ingredients across your entire collection.

Tech stack

HTMLPythonDocker

Getting it running

Difficulty · moderate Time to first run · 1h+

Requires Docker and a server, not designed for public internet access, intended for private home network use.

Free to self-host for personal use, but you cannot offer it as a paid hosted service to others, per the AGPL with selling exception.

In plain English

Tandoor Recipes is a self-hosted web application for organizing a personal recipe collection. You store your recipes in one place, plan your meals for the week, and generate shopping lists automatically from whatever you decide to cook. The project is free and open source, built by volunteers in their spare time. The core idea is that your recipe collection lives on a server you control, not a service that could disappear. You can import recipes from thousands of cooking websites by pasting a link, bring in collections from other recipe managers, or sync files through Dropbox or Nextcloud. The app also uses AI to pull nutrition facts from images and sort recipe steps into a logical order. Beyond just storing recipes, Tandoor handles the workflow around cooking. You can scale a recipe up or down for more or fewer servings, organize recipes into cookbooks, tag ingredients and apply those tags in bulk, and merge or rename ingredients across your whole collection when naming drifts over time. Search is full-text and supports fuzzy matching, so you can find a recipe even with a slight spelling variation. Multiple people can share access to the same Tandoor instance. You can share recipes with family or friends, and a basic permission system controls who can see and edit what. The app is optimized for mobile devices and is available in many languages. It is not designed to run as a public website open to anyone on the internet. Setup is done through Docker, with example configurations also provided for a few other self-hosting platforms. A hosted version is available from the developers for users in Germany who prefer not to run their own server. The code is licensed under the GNU AGPL with a selling exception, meaning you can self-host it for free, but you cannot sell it as a hosted service.

Copy-paste prompts

Prompt 1
Set up Tandoor Recipes using Docker Compose on a home server and import my first recipe from a cooking website URL.
Prompt 2
Write a Docker Compose file for Tandoor Recipes that includes the database, sets up a volume for images, and exposes it on port 8080.
Prompt 3
How do I configure Tandoor Recipes to sync recipes from a Nextcloud folder and share view-only access with two family members?
Prompt 4
Create a script to bulk-import a recipe collection from another recipe manager's export format into Tandoor Recipes via its API.
Open on GitHub → Explain another repo

← tandoorrecipes on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.