mealie
Mealie is a self hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the url and mealie will automatically import the relevant data or add a family recipe with the UI editor
Top Related Projects
Quick Overview
Mealie is a self-hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue. It allows users to manage their recipes, create meal plans, and generate shopping lists, all within a modern and user-friendly interface.
Pros
- Self-hosted solution, providing full control over data and privacy
- Comprehensive features including recipe management, meal planning, and shopping list generation
- Clean and intuitive user interface
- Active development and community support
Cons
- Requires technical knowledge for setup and maintenance
- May have limited integrations compared to commercial alternatives
- Self-hosting means users are responsible for updates and security
Getting Started
To get started with Mealie, follow these steps:
- Install Docker on your system
- Run the following command to start Mealie:
docker run -d \
--name mealie \
-p 9925:9000 \
-v /path/to/data:/app/data \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=America/New_York \
hkotel/mealie:latest
- Access Mealie at
http://localhost:9925 - Create an admin account and start adding your recipes
For more detailed instructions and configuration options, refer to the official documentation at https://hay-kot.github.io/mealie/
Competitor Comparisons
Application for managing recipes, planning meals, building shopping lists and much much more!
Pros of Recipes
- More extensive feature set, including meal planning and shopping lists
- Larger and more active community, with frequent updates and contributions
- Better support for internationalization and multiple languages
Cons of Recipes
- More complex setup and configuration process
- Higher system requirements due to additional features
- Steeper learning curve for new users
Code Comparison
Mealie (Python):
@router.post("/api/recipes", response_model=RecipeSchema, status_code=201)
def create_recipe(
recipe: RecipeSchema = Body(...),
db: Session = Depends(get_db),
current_user: User = Depends(get_current_user),
):
return crud.recipes.create(db, recipe, current_user)
Recipes (Python):
class RecipeViewSet(viewsets.ModelViewSet):
queryset = Recipe.objects.all()
serializer_class = RecipeSerializer
permission_classes = (IsOwner,)
filter_backends = (DjangoFilterBackend, SearchFilter, OrderingFilter)
filterset_class = RecipeFilter
search_fields = ('name', 'description')
ordering_fields = ('name', 'created_at')
Both projects use Python for backend development, but Recipes utilizes Django Rest Framework for API implementation, while Mealie uses FastAPI. Recipes' code demonstrates more built-in features for filtering, searching, and ordering, which aligns with its more extensive feature set.
Homebox is the inventory and organization system built for the Home User
Pros of Homebox
- More versatile: Manages various home items beyond recipes
- Simpler setup: Easier to get started with minimal configuration
- Mobile-friendly: Responsive design works well on smartphones
Cons of Homebox
- Less recipe-focused: Fewer specialized features for recipe management
- Smaller community: Less active development and fewer contributors
- Limited integrations: Fewer options for connecting with external services
Code Comparison
Mealie (Python):
@router.get("/{recipe_id}", response_model=RecipeSchema)
def get_recipe(recipe_id: str, db: Session = Depends(get_db)):
recipe = crud.recipe.get(db, id=recipe_id)
if not recipe:
raise HTTPException(status_code=404, detail="Recipe not found")
return recipe
Homebox (Go):
func (h *Handler) GetItem(c echo.Context) error {
id := c.Param("id")
item, err := h.service.GetItem(id)
if err != nil {
return echo.NewHTTPError(http.StatusNotFound, "Item not found")
}
return c.JSON(http.StatusOK, item)
}
Both projects use similar patterns for handling API requests, but Mealie uses Python with FastAPI, while Homebox uses Go with the Echo framework. Mealie's code is more specific to recipe management, while Homebox's code is more generic for handling various item types.
Convert 
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
Mealie
A Place For All Your Recipes
Explore the docs »
View Demo
·
Report Bug
·
GitHub Container Registry
About The Project
Mealie is a self hosted recipe manager, meal planner and shopping list with a RestAPI backend and a reactive frontend built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the URL and Mealie will automatically import the relevant data, or add a family recipe with the UI editor. Mealie also provides an API for interactions from 3rd party applications.
Key Features
- Recipe imports: Create recipes, by importing from a URL or entering data manually
- Meal Planner: Use the Meal Planner to plan your what you'll cook for the next week
- Shopping List: Put the necessary ingredients on your Shopping List, organised into sections of your local supermarket
- Cookbooks: Group recipes into Cookbooks based on your own criteria
- Docker: Easy Docker deployment
- Localisation: Translations for 35+ languages
Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. If you're going to be working on the code-base, you'll want to use the nightly documentation to ensure you get the latest information.
- See the Contributors Guide for help getting started.
- We use VSCode Dev Containers to make it easy for contributors to get started!
If you are not a coder, you can still contribute financially. Financial contributions help me prioritize working on this project over others and helps me know that there is a real demand for project development.
Translations
Translations can be a great way for non-coders to contribute to the project. We use Crowdin to allow several contributors to work on translating Mealie. You can simply help by voting for your preferred translations, or even by completely translating Mealie into a new language.
For more information, check out the translation page on the contributor's guide.
License
Distributed under the AGPL License. See LICENSE for more information.
Sponsors
Huge thanks to all the sponsors of this project on Github Sponsors and Buy Me a Coffee. Without you, this project would surely not be possible.
Thanks to Depot for providing build instances for our Docker image builds.
Top Related Projects
Convert designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot