grocy/grocy
Grocy
Grocy is a self-hosted household management system designed to track grocery inventory, chore logs, and equipment manuals within a private home environment. It functions as a grocery inventory manager, a digital recipe and meal planner, and a household chore tracker.
The system distinguishes itself through a REST API that exposes all household functions for home automation integration and a barcode-based stock controller that utilizes external databases to identify products and update stock levels. It also features recipe web scraping to automatically extract culinary data from external websites.
The platform covers a broad range of domestic capabilities, including inventory tracking with expiration date monitoring, automated shopping list generation, and product lifecycle journaling. It also manages home equipment catalogs, recurring chore logging, and meal planning linked to current stock levels.
The system provides a dedicated smartphone interface for managing inventory and household data on the go.
Features
- Grocery Management Tools - Monitors stock levels, expiration dates, and storage locations to reduce food waste and automate shopping.
- Inventory Tracking - Tracks stock levels, expiration dates, and storage locations for groceries and home supplies.
- Domestic Activity Tracking - Records the completion of recurring domestic tasks to track household maintenance history.
- Expiration Tracking - Tracks product expiration dates to identify items that need to be used soon to reduce waste.
- Household Chore Tracking - Logs the completion of recurring household maintenance tasks and manages general to-do lists.
- Household Management Systems - Provides a central self-hosted platform for tracking grocery inventory, chore logs, and equipment manuals.
- Recipe Management Systems - Stores cooking recipes and automatically generates shopping lists based on inventory and planned meals.
- Inventory Linking - Identifies which recipes use specific inventory items to help plan meals based on available stock.
- Meal Planning - Schedules meals based on recipes and exports the required ingredients to a shopping list.
- Barcode Integration - Uses barcode scanning and external databases to quickly identify products and update stock levels.
- Barcode Scanners - Uses mobile devices or external scanners to identify products and process stock changes efficiently.
- Stock-Based Generation - Generates shopping lists by comparing current inventory levels against user-defined minimum stock thresholds.
- REST APIs - Provides a standard REST API that exposes all household functions for third-party integrations.
- Barcode Product Lookups - Fetches product details from external databases using barcodes to automate inventory creation.
- Equipment Catalogs - Provides a centralized digital repository for home device instruction manuals and technical specifications.
- Inventory Alerts - Connects inventory and shopping list data to home automation platforms to trigger alerts based on stock levels.
- Home Equipment Catalogs - Maintains a centralized digital repository of instruction manuals and technical specifications for household devices.
- Stock Journaling - Records the purchase, consumption, and transfer of items with a detailed stock journal and price history.
- Stock Journals - Maintains a detailed historical log of every product purchase, consumption, and transfer.
- Todo List Managers - Maintains a general list of to-do items to track miscellaneous household obligations.
- Dynamic Data Schemas - Enables addition of user-defined fields and custom objects to expand the data model.
- Purchase Entry - Records new stock using barcode scanners or device cameras to maintain an accurate inventory count.
- Smart Home Orchestration - Connects stock levels and task data to home automation platforms via an API for alerts.
- Home Automation - Exposes all household functions via a REST API for integration with home automation platforms.
- Custom Data Fields - Supports user-defined fields and new objects to track specialized household information.
- Mobile Interfaces - Provides a dedicated smartphone interface for managing groceries and inventory on the go.
- Shopping List Generators - Generates organized shopping lists based on minimum stock levels and required recipe ingredients.
- External API Integrations - Connects to remote barcode databases to fetch product details for inventory automation.
- Business and Operations - Manages household inventory and groceries.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
