mealie-recipes/mealie
Mealie
Mealie is a self-hosted recipe management platform designed for personal data ownership and household meal planning. It functions as a digital kitchen assistant that allows users to import, organize, and digitize culinary content from websites, images, and videos into a structured, searchable database. The application supports multi-user collaboration through household management, enabling shared access to recipes and meal plans while maintaining distinct permissions.
The platform distinguishes itself through extensive automation and integration capabilities. It features a programmatic interface that supports webhooks and custom actions, allowing users to synchronize shopping lists, trigger external workflows, and display menu information on home automation dashboards. The system also incorporates advanced ingestion tools, including AI-powered ingredient parsing and automated recipe extraction, to streamline the digitization of diverse culinary sources.
Beyond core management, the application provides a robust infrastructure for security and extensibility. It supports enterprise-grade authentication through OpenID Connect and LDAP, alongside granular role-based access control. The system is built for flexible deployment, offering containerized packaging and support for both lightweight file-based storage and high-concurrency relational databases.
The software is distributed as a containerized application, facilitating consistent deployment across various host environments.
Features
- Recipe Management Systems - Organizes and digitizes culinary content from various sources into a structured, searchable personal database.
- Grocery Management Tools - Provides comprehensive tools for organizing recipes, planning weekly meals, and generating automated shopping lists.
- Automation - Generates automated meal plans based on user-defined rules to simplify kitchen management.
- Weekly Planning - Organizes weekly meal schedules using a calendar interface with automated recipe selection rules.
- Private Data Hosting - Enables private hosting of recipe and meal planning services to maintain full control over personal data.
- LDAP Authentication - Validates user credentials against external LDAP directory services for centralized access management.
- Recipe Search Engines - Provides intelligent search capabilities including keyword and fuzzy matching to locate specific recipes.
- Backup and Recovery - Manages full database snapshots to ensure data persistence and recovery for the entire installation.
- PostgreSQL Persistence - Utilizes relational database management systems to store application metadata and enable advanced search features.
- Data Exposure - Provides a programmatic interface for external applications to import or export recipe and meal information.
- Multi-Tenant Data Management - Isolates data between different user groups and households to maintain private meal plans and shared recipe access.
- Relational Database Management Systems - Uses relational database engines to store application state and enable complex data queries.
- Container Image Packaging - Packages the application into portable container images for consistent deployment across environments.
- External Identity Provider Integration - Integrates with third-party identity providers using OpenID Connect for centralized authentication.
- Identity Provider Connections - Integrates with external identity providers to manage secure user authentication and centralized login.
- Role-Based Access Control - Manages user permissions and data isolation through granular role-based access control.
- AI-Powered Content Processors - Utilizes artificial intelligence to automatically extract ingredient lists from unstructured text.
- Internet Services - Self-hostable recipe management server with a rich interface.
- General Productivity Tools - Self-hosted recipe management and meal planning.
- Personal Organization Tools - Self-hosted recipe management server with a rich interface.
- Content Extraction Engines - Parses and normalizes raw web content from recipe URLs into structured data.
- Database Schema Migrations - Automates incremental database schema updates to maintain integrity across software versions.
- REST APIs - Exposes a programmatic interface for external applications to synchronize recipe data and shopping lists.
- Containerized Application Deployment - Packages the application and its runtime into portable images for consistent deployment across environments.
- OpenID Connect Providers - Supports enterprise-grade authentication by integrating with OIDC and LDAP services for secure session management.
- Identity Federation - Delegates authentication and authorization to external providers using OpenID Connect and LDAP.
- Shopping List Generators - Compiles ingredients from planned meals into organized grocery lists.
- Bulk Importers - Processes text files containing lists of recipe URLs to automatically fetch and add multiple recipes at once.
- Data Synchronization - Synchronizes recipe ingredients with external shopping list services over local network connections.
- Digitization Tools - Converts images of handwritten or typed recipes into structured data.
- Storage Backend Configurators - Allows selecting between lightweight file-based storage or relational database systems.
- Data Query Filters - Allows retrieving specific data subsets using pagination, filtering, and sorting parameters.
- Automated Workflow Orchestration - Orchestrates automated workflows by triggering external services via webhooks and APIs.
- Account Synchronization - Links external identity provider accounts to local profiles automatically upon first login.
- API Request Authentication - Authorizes programmatic access to services using long-lived tokens generated through user profiles.
- Webhook Event Notifications - Triggers external services via automated webhook notifications when system events occur.
- Application State Resetters - Imports backup files to overwrite the current database and reset the application state.
- Audio Transcription - Extracts audio from video links and generates transcripts for recipe parsing.
- Home Automation Integrations - Integrates with home automation systems to display upcoming menu items on external dashboards.
- Collection Organization - Categorizes and labels recipes using custom tags and key-value pairs to enable flexible sorting.
- Automated Extraction Schedulers - Schedules recurring triggers to external endpoints for automated workflow and system updates.
- Data Import and Export - Routes diverse input sources through specialized extraction and parsing logic for data ingestion.
- Local File Storage - Persists application data directly to local disk storage for small-scale deployments.
- Data Export - Generates compressed archives of application data to facilitate manual backups.
- Ingredient Parsers - Allows integrating external logic for extracting recipe ingredients through a standardized interface.
- User Role Management - Assigns specific roles and administrative privileges to users for managing groups and system-level tasks.
- Custom Action Handlers - Enables executing custom web requests to trigger external workflows based on recipe data.
