explaingit

mealie-recipes/mealie

12,200PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

A self-hosted recipe manager and weekly meal planner you install on your own server, save recipes from any cooking website, plan meals, and auto-generate shopping lists organized by store section, all private and ad-free.

Mindmap

mindmap
  root((repo))
    What it does
      Recipe storage
      Meal planning
      Shopping lists
    Tech stack
      Python backend
      Vue frontend
      Docker deploy
    Use cases
      Home cooks
      Family kitchens
      Private hosting
    Audience
      General users
      Self-hosters
    Features
      URL import
      35 languages
      REST API
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 URL into your self-hosted Mealie instance.

USE CASE 2

Plan a week of dinners and automatically generate a shopping list sorted by supermarket section.

USE CASE 3

Run a private household recipe collection for your family with no ads, no tracking, and no account required on a third-party site.

Tech stack

PythonVueDocker

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Docker and a docker-compose file, you must manage your own server or home computer for hosting.

Free to use and self-host, if you build a product on top of it and distribute it to others, you must share your source code changes under the same license.

In plain English

Mealie is a self-hosted recipe manager and meal planner you install and run on your own computer or server. It keeps all your recipes in one place, private and under your control, rather than storing them on someone else's website. It has a web interface built with Vue (a popular JavaScript tool for building interactive pages) and a programming interface that lets other apps connect to it. Adding recipes is straightforward: paste a URL from a cooking website and Mealie automatically pulls in the recipe details, or type one in manually using the built-in editor. Once your recipes are saved, you can group them into collections called Cookbooks based on whatever categories make sense to you, such as weeknight dinners or baked goods. The meal planner lets you schedule what you want to cook across the coming week. When you add meals to the planner, Mealie can build a shopping list from the required ingredients and organize them into sections that match the layout of your local supermarket, which cuts down on back-and-forth while you shop. Mealie is available in more than 35 languages, making it accessible to a wide range of households. It is designed to run in Docker, a tool that packages software so it can be installed with minimal setup on most home computers and servers. The project uses the AGPL license, which means the code is open source and free to use, but if you build something on top of it and distribute it to others, you must also share your changes. This is a community project funded by individual sponsors. If you want to help without writing code, contributing translations through the Crowdin platform is a supported option the project actively encourages.

Copy-paste prompts

Prompt 1
Give me a docker-compose.yml to get Mealie running on my home server with persistent storage for recipes.
Prompt 2
Write a Python script using the Mealie REST API to bulk-import a list of recipe URLs from a CSV file.
Prompt 3
Show me how to set up a weekly meal plan in Mealie and export the resulting shopping list as a plain text file.
Open on GitHub → Explain another repo

← mealie-recipes on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.