Stars
Forks
Watchers
Developer links
Grocy
Grocy is a household management system, bringing ERP-grade inventory tracking to kitchens, pantries, and homes worldwide. The stock management system tracks products with expiration dates, best-before dates, and opened tracking, while barcode scanning via USB readers or device cameras with Open Food Facts product lookup enables rapid item entry. Minimum stock amounts trigger automatic shopping list entries so frequently used products never run out, and multiple shopping lists can be maintained and shared across household members. Recipe management links ingredients directly to stock inventory, showing at-a-glance fulfillment status and a Due Score that highlights recipes best suited for consuming items approaching expiration. The meal planner organizes daily meals across customizable time periods and adds all missing ingredients to shopping lists with one click. Chore tracking schedules recurring household tasks with assignment to specific members, due date tracking, and completion history logging. Battery management monitors charge cycles for household devices with configurable reminder intervals. Custom fields and userfields extend any entity with additional data, while feature flags disable unused modules to simplify the interface. The RESTful API with integrated Swagger UI at the /api endpoint exposes every operation the web frontend uses, enabling third-party integrations with home automation systems. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT licensed.
Benefits
- Complete Household Inventory Management
- Track grocery stock with expiration dates, opened tracking, and barcode scanning via Open Food Facts lookup, with minimum stock alerts triggering automatic shopping list entries.
- Recipe-Aware Meal Planning
- Recipes link directly to stock inventory showing ingredient fulfillment status, while Due Scores highlight meals that use items approaching expiration to reduce food waste.
- Household Chore and Task Scheduling
- Schedule recurring chores with member assignment, due date tracking, and completion history alongside battery charge cycle monitoring with configurable reminder intervals.
- Full RESTful API for Integration
- Every operation available in the web frontend is exposed through the REST API with integrated Swagger UI documentation, enabling home automation and third-party integrations.
Features
- Barcode Product Lookup
- USB barcode readers and device camera scanning with Open Food Facts integration add products instantly, with plugin support for additional lookup services.
- Automated Shopping Lists
- Minimum stock amounts trigger automatic list entries, with multiple lists shareable across household members and one-click addition of missing recipe ingredients.
- Stock Expiration Tracking
- Best-before and expiration date monitoring with opened tracking surfaces items approaching due dates across stock overview and recipe Due Score calculations.
- Custom Fields and Feature Flags
- Extend any entity with custom data fields and userfields, while feature flags disable unused modules like price tracking or chores to simplify the interface.
- Responsive Multi-Device Interface
- Fully responsive web interface works on desktop, tablet, and phone browsers with touch-optimized controls for kitchen use and barcode scanning.