# grocy/grocy

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/grocy-grocy).**

8,748 stars · 727 forks · Blade · mit

## Links

- GitHub: https://github.com/grocy/grocy
- Homepage: https://grocy.info
- awesome-repositories: https://awesome-repositories.com/repository/grocy-grocy.md

## Topics

`erp` `food` `groceries` `grocy` `home` `meal-planner` `ownyourdata` `php` `self-hosted`

## Description

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.

## Tags

### Business & Productivity Software

- [Grocery Management Tools](https://awesome-repositories.com/f/business-productivity-software/grocery-management-tools.md) — Monitors stock levels, expiration dates, and storage locations to reduce food waste and automate shopping.
- [Domestic Activity Tracking](https://awesome-repositories.com/f/business-productivity-software/domestic-activity-tracking.md) — Records the completion of recurring domestic tasks to track household maintenance history. ([source](https://grocy.info/de))
- [Expiration Tracking](https://awesome-repositories.com/f/business-productivity-software/expiration-tracking.md) — Tracks product expiration dates to identify items that need to be used soon to reduce waste. ([source](https://grocy.info))
- [Household Chore Tracking](https://awesome-repositories.com/f/business-productivity-software/household-chore-tracking.md) — Logs the completion of recurring household maintenance tasks and manages general to-do lists.
- [Household Management Systems](https://awesome-repositories.com/f/business-productivity-software/household-management-systems.md) — Provides a central self-hosted platform for tracking grocery inventory, chore logs, and equipment manuals.
- [Recipe Management Systems](https://awesome-repositories.com/f/business-productivity-software/recipe-management-systems.md) — Stores cooking recipes and automatically generates shopping lists based on inventory and planned meals.
- [Inventory Linking](https://awesome-repositories.com/f/business-productivity-software/recipe-management-systems/inventory-linking.md) — Identifies which recipes use specific inventory items to help plan meals based on available stock. ([source](https://demo-prerelease.grocy.info/))
- [Meal Planning](https://awesome-repositories.com/f/business-productivity-software/wellness-planning/meal-planning.md) — Schedules meals based on recipes and exports the required ingredients to a shopping list. ([source](https://grocy.info))
- [Barcode Product Lookups](https://awesome-repositories.com/f/business-productivity-software/barcode-product-lookups.md) — Fetches product details from external databases using barcodes to automate inventory creation. ([source](https://cdn.jsdelivr.net/gh/grocy/grocy@master/README.md))
- [Equipment Catalogs](https://awesome-repositories.com/f/business-productivity-software/equipment-catalogs.md) — Provides a centralized digital repository for home device instruction manuals and technical specifications. ([source](https://grocy.info/))
- [Inventory Alerts](https://awesome-repositories.com/f/business-productivity-software/home-automation-integrations/home-automation-controller-integrations/inventory-alerts.md) — Connects inventory and shopping list data to home automation platforms to trigger alerts based on stock levels. ([source](https://grocy.info/links))
- [Home Equipment Catalogs](https://awesome-repositories.com/f/business-productivity-software/home-equipment-catalogs.md) — Maintains a centralized digital repository of instruction manuals and technical specifications for household devices.
- [Stock Journaling](https://awesome-repositories.com/f/business-productivity-software/inventory-management-systems/stock-journaling.md) — Records the purchase, consumption, and transfer of items with a detailed stock journal and price history. ([source](https://demo-prerelease.grocy.info/))
- [Stock Journals](https://awesome-repositories.com/f/business-productivity-software/stock-journals.md) — Maintains a detailed historical log of every product purchase, consumption, and transfer.
- [Todo List Managers](https://awesome-repositories.com/f/business-productivity-software/todo-list-managers.md) — Maintains a general list of to-do items to track miscellaneous household obligations. ([source](https://grocy.info))

### Data & Databases

- [Inventory Tracking](https://awesome-repositories.com/f/data-databases/inventory-tracking.md) — Tracks stock levels, expiration dates, and storage locations for groceries and home supplies.
- [Barcode Integration](https://awesome-repositories.com/f/data-databases/consumer-offset-trackers/consumer-lag-monitoring/consumable-stock-monitoring/product-stock-monitoring/barcode-integration.md) — Uses barcode scanning and external databases to quickly identify products and update stock levels.
- [Dynamic Data Schemas](https://awesome-repositories.com/f/data-databases/dynamic-data-schemas.md) — Enables addition of user-defined fields and custom objects to expand the data model.

### Development Tools & Productivity

- [Barcode Scanners](https://awesome-repositories.com/f/development-tools-productivity/barcode-scanners.md) — Uses mobile devices or external scanners to identify products and process stock changes efficiently. ([source](https://grocy.info/addons))
- [Purchase Entry](https://awesome-repositories.com/f/development-tools-productivity/barcode-scanners/purchase-entry.md) — Records new stock using barcode scanners or device cameras to maintain an accurate inventory count. ([source](https://grocy.info/de))

### User Interface & Experience

- [Stock-Based Generation](https://awesome-repositories.com/f/user-interface-experience/selection-lists/shopping-list-generators/stock-based-generation.md) — Generates shopping lists by comparing current inventory levels against user-defined minimum stock thresholds.
- [Custom Data Fields](https://awesome-repositories.com/f/user-interface-experience/field-customization/custom-data-fields.md) — Supports user-defined fields and new objects to track specialized household information. ([source](https://grocy.info))
- [Mobile Interfaces](https://awesome-repositories.com/f/user-interface-experience/mobile-interfaces.md) — Provides a dedicated smartphone interface for managing groceries and inventory on the go. ([source](https://grocy.info/addons))
- [Shopping List Generators](https://awesome-repositories.com/f/user-interface-experience/selection-lists/shopping-list-generators.md) — Generates organized shopping lists based on minimum stock levels and required recipe ingredients. ([source](https://grocy.info))

### Web Development

- [REST APIs](https://awesome-repositories.com/f/web-development/rest-apis.md) — Provides a standard REST API that exposes all household functions for third-party integrations. ([source](https://cdn.jsdelivr.net/gh/grocy/grocy@master/README.md))
- [External API Integrations](https://awesome-repositories.com/f/web-development/external-api-integrations.md) — Connects to remote barcode databases to fetch product details for inventory automation.

### DevOps & Infrastructure

- [Smart Home Orchestration](https://awesome-repositories.com/f/devops-infrastructure/automation-orchestration/task-execution-frameworks/home-automation/smart-home-orchestration.md) — Connects stock levels and task data to home automation platforms via an API for alerts.

### Hardware & IoT

- [Home Automation](https://awesome-repositories.com/f/hardware-iot/connectivity-iot/home-automation.md) — Exposes all household functions via a REST API for integration with home automation platforms.

### Part of an Awesome List

- [Business and Operations](https://awesome-repositories.com/f/awesome-lists/productivity/business-and-operations.md) — Manages household inventory and groceries.