Website • Installation • Docs • Demo • Community • Discord

• 🥗 Manage your recipes - Manage your ever growing recipe collection
• 📆 Plan - multiple meals for each day
• 🛒 Shopping lists - via the meal plan or straight from recipes
• 🪄 use AI to recognize images, sort recipe steps, find nutrition facts and more
• 📚 Cookbooks - collect recipes into books
• 👪 Share and collaborate on recipes with friends and family

• 🔍 Powerful & customizable search with fulltext support and TrigramSimilarity
• 🏷️ Create and search for tags, assign them in batch to all files matching certain filters
• ↔️ Quickly merge and rename ingredients, tags and units
• 📥️ Import recipes from thousands of websites supporting ld+json or microdata
• ➗ Support for fractions or decimals
• 🐳 Easy setup with Docker and included examples for Kubernetes, Unraid and Synology
• 🎨 Customize your interface with themes
• 📦 Sync files with Dropbox and Nextcloud

• 📱Optimized for use on mobile devices
• 🌍 localized in many languages thanks to the awesome community
• 📥️ Import your collection from many other recipe managers
• ➕ Many more like recipe scaling, image compression, printing views and supermarkets

This application is meant for people with a collection of recipes they want to share with family and friends or simply store them in a nicely organized way. A basic permission system exists but this application is not meant to be run as a public page.

Documentation can be found here.

Tandoor is developed by volunteers in their free time just because its fun. That said earning some money with the project allows us to spend more time on it and thus make improvements we otherwise couldn't. Because of that there are several ways you can support us

• GitHub Sponsors You can sponsor contributors of this project on GitHub: vabene1111
• Patron You can sponsor contributors of this project on Patron: vabene111
• Host at Hetzner We have been very happy customers of Hetzner for multiple years for all of our projects. If you want to get into self-hosting or are tired of the expensive big providers, their cloud servers are a great place to get started. When you sign up via our referral link you will get 20€ worth of cloud credits and we get a small kickback too.
• Let us host for you We are offering a hosted version where all profits support us and the development of tandoor (currently only available in germany).

本项目支持通过 GitHub Actions 自动部署到 CapRover ���台。

项目配置了两个独立的部署环境：

• 生产环境：从 main 分支部署，使用 ipusi/cook-flow:latest 镜像
• 开发环境：从 develop 分支部署，使用 ipusi/cook-flow:dev 镜像

1. 在 CapRover 创建应用

   • 为生产环境创建应用（如 cook-flow-prod）
   • 为开发环境创建应用（如 cook-flow-dev）
   • 在应用的 "Deployment" 标签页启用 App Token 并复制

2. 配置 GitHub Secrets

   在 GitHub 仓库设置中添加以下 Secrets：

   生产环境：

   • CAPROVER_SERVER_PROD - CapRover 服务器地址（如：https://captain.your-domain.com）
   • APP_NAME_PROD - 生产环境应用名称
   • APP_TOKEN_PROD - 生产环境应用 Token

   开发环境：

   • CAPROVER_SERVER_DEV - CapRover 服务器地址
   • APP_NAME_DEV - 开发环境应用名称
   • APP_TOKEN_DEV - 开发环境应用 Token

推送代码到相应分支即可自动触发部署：

develop 分支推送
    ↓
build-docker.yml 构建 dev 镜像
    ↓
deploy-caprover-development.yml 部署到开发环境

main 分支推送
    ↓
deploy-caprover-production.yml 部署生产环境
    (使用已有的 latest 镜像)

tag 推送 (v*)
    ↓
build-docker.yml 构建版本镜像和 latest 镜像

构建的 Docker 镜像会推送到 Docker Hub：

• ipusi/cook-flow:latest - 生产环境镜像
• ipusi/cook-flow:dev - 开发环境镜像
• ipusi/cook-flow:vX.Y.Z - 版本标签镜像

您也可以在 GitHub Actions 页面手动触发部署 workflow。

Contributions are welcome but please read this BEFORE contributing anything!

Share some information on how you use Tandoor to help me improve the application Google Survey

Beginning with version 0.10.0 the code in this repository is licensed under the GNU AGPL v3 license with a common clause selling exception. See LICENSE.md for details.

NOTE: There appears to be a whole range of legal issues with licensing anything other than the standard completely open licenses. I am in the process of getting some professional legal advice to sort out these issues. Please also see Issue 238 for some discussion and reasoning regarding the topic.

Reasoning This software and all its features are and will always be free for everyone to use and enjoy.

The reason for the selling exception is that a significant amount of time was spend over multiple years to develop this software. A paid hosted version which will be identical in features and code base to the software offered in this repository will likely be released in the future (including all features needed to sell a hosted version as they might also be useful for personal use). This will not only benefit me personally but also everyone who self-hosts this software as any profits made through selling the hosted option allow me to spend more time developing and improving the software for everyone. Selling exceptions are approved by Richard Stallman and the common clause license is very permissive (see the FAQ).