Repolode
Submit
alexbates

alexbates/Tamari

A self-hosted recipe manager web app built with Python and Flask, covering recipes, shopping lists and meal planning.

Open-source alternative to:Paprika Recipe Manager

View on GitHubWebsite
Stars
144
Forks
10
Open issues
8
Last commit
23 days ago

What is it?

Tamari is a recipe manager web application written in Python with the Flask framework. Users create accounts, store recipes with ingredients, instructions, time estimates, servings, nutrition info and photos, and search them with real-time search-as-you-type. Recipes stay private by default and can be made public and shared by URL.

Beyond storage, the app connects recipes to everyday cooking tasks. Ingredients from a recipe can be added to per-store shopping lists in one click, with barcode scanning for adding items. A meal planner assigns recipes to dates up to 30 days ahead. Recipes can also be imported from a built-in collection of recipes drawn from sharing websites.

Tamari can be run with Docker, using a persistent volume and optional email settings for password reset, or installed manually on Debian or Ubuntu with gunicorn. It includes a REST API for recipes, shopping lists and meal plans, and a responsive interface with light and dark themes.

Key features

  • 01User accounts with email and password login, plus optional password reset by email.
  • 02Recipe storage with ingredients, instructions, nutrition info and photos, and public sharing links.
  • 03Real-time search-as-you-type and browsing by category or favorites.
  • 04Per-store shopping lists with one-click import of recipe ingredients and barcode scanning.
  • 05Meal planner for assigning recipes to dates up to 30 days ahead.
  • 06REST API for recipes, shopping lists and meal plans.

Use cases

  • Keeping a private family recipe collection on a home server.
  • Planning the week's meals and generating a shopping list from chosen recipes.
  • Sharing selected recipes with friends through public links.
  • Running a self-hosted recipe app for a small team or household via Docker.

Quick start

  1. 1

    Run the Docker container

    docker run -d --restart=always -p 4888:4888 -v tamariappdata:/app/appdata --name tamari alexbates/tamari:1.7.1
  2. 2

    Open the app in your browser

Things to know

  • Manual installation is documented only for Debian 12 and Ubuntu 24.10.

Topics

#recipes#flask#python#self-hosted#meal-planner#shopping-list#docker#cooking#cooking-recipes#recipe-app

FAQ

What is Tamari?
A self-hosted recipe manager web app built with Python and Flask, covering recipes, shopping lists and meal planning. Tamari is a recipe manager web application written in Python with the Flask framework. Users create accounts, store recipes with ingredients, instructions, time estimates, servings, nutrition info and photos, and search them with real-time search-as-you-type. Recipes stay private by default and can be made public and shared by URL.
Is Tamari free to use? What license does it have?
Tamari is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is Tamari still maintained?
Actively maintained. The last commit to Tamari was on Sep 27, 2026.
What can I use Tamari for?
Keeping a private family recipe collection on a home server. Planning the week's meals and generating a shopping list from chosen recipes. Sharing selected recipes with friends through public links. Running a self-hosted recipe app for a small team or household via Docker.
How do I install Tamari?
Run the Docker container: docker run -d --restart=always -p 4888:4888 -v tamariappdata:/app/appdata --name tamari alexbates/tamari:1.7.1 Open the app in your browser
Where can I get Tamari?
The source code and installation instructions are on GitHub: https://github.com/alexbates/Tamari

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects