Tamari is a free and open-source web app that helps home cooks and self-hosters manage recipes, plan meals, and generate shopping lists.

---

🚀 Overview

Tamari is a fully-featured, self-hostable recipe manager web application that lets you collect, organize, and utilize recipes efficiently without relying on proprietary cloud services.

It solves the problem of scattered recipes across websites by scraping and importing from over 107,000 recipes on 50+ sites, provides meal planning up to 30 days, auto-generates shopping lists, and keeps everything private and organized with favorites and categories.

Built for home cooks who cook regularly, meal preppers, and privacy-conscious self-hosting enthusiasts who want full control over their data.

Answer these questions:

• What problem does this project solve? Managing disorganized recipes, manual ingredient tracking, and lack of integrated planning in a privacy-friendly way.
• Who is it built for? Individual cooks and self-hosters.
• Why did you build it? Alex Bates created it as a personal project to provide a robust, open-source alternative to commercial recipe apps, emphasizing self-hosting and web scraping capabilities.

Keep it human and honest.

---

✨ Key Features

• Explore & Import: Browse and auto-parse over 107,000 recipes from 50+ websites, save with one click—no need to visit the source.
• Organization: Favorites, categories, search-as-you-type, private recipes with optional sharing.
• Meal Planner: Schedule recipes up to 30 days ahead for efficient cooking planning.
• Shopping Lists: One-click add ingredients from recipes, check off items, barcode scanning support, multiple lists per store.
• Customization: Themes (light/dark), accent colors, profile pics, font sizes, recipe display styles.
• Backups & API: ZIP import/export, REST API for recipes/shopping/meal plans. Optional: Responsive design for all devices.

---

🛠 Tech Stack

• Frontend: HTML, CSS, JavaScript (responsive)
• Backend: Python, Flask, Gunicorn
• Database: Flask-SQLAlchemy (SQLite default, supports others)
• Auth: Custom (email/password with reset)
• Hosting: Docker, public instance available

---

👥 Who Is This For?

This project is useful for:

• Home cooks who want to ___ organize and scrape recipes easily
• Self-hosting enthusiasts looking for ___ privacy-focused apps
• Meal preppers building ___ personalized cooking schedules

---

📸 Screenshots / Demo

• Live demo: https://app.tamariapp.com
• GitHub: https://github.com/alexbates/Tamari

---

🔥 Project Status

• 🟢 Actively building

Last updated: 2026-03-24

---

❓ FAQ

Is this project free?

Yes — Free and open source (GPL-3.0 License) (Explain briefly.)

---

Is the source code available?

Yes — https://github.com/alexbates/Tamari

---

Can I contribute?

Open an issue on GitHub for feature requests, bug reports, or improvements. Pull requests are welcome.

---

📬 Contact & Links

• Website: https://tamariapp.com
• GitHub: https://github.com/alexbates/Tamari
• Twitter/X:
• Email:

---

Built with ❤️ and kept warm on WarmIndex.