This application implements some experimental features for Grocy. The main goal is to work with Grocy in the background and do most things automatically so you can keep using Grocy, Grocy Android, Home Assistant Grocy Addon etc. Therefore, it uses Grocy as a database while extensively utilizing the UserField functionality.
See the React Client.
NOTE: This app is released prematurely since it contains some specific rules that we used for our setup
which might not be transferable in other environments. For example, all our product names have three translations
English, German, and Macedonian are separated by /. Some features use English names, and some use German.
We intend to make this configurable and even use separate UserFields.
- You must install the Python dependencies listed in the
requirements.txt. - Provide
config.ymlwith API keys of the services you want to use. Some are critical. See config_example.yml. - Start the main.py with the unicorn server. For more info, see the FastAPI documentation.
NOTE: Your Grocy server must be available to start the application.
once you start the server, you can see all the available API calls on http://localhost:5000/api/docs
The features developed here are purely experimental. However, we intend to make them stable for production use. They will be removed in case the main Grocy project implements them, but as it seems some of them will never be in the scope of that project.
Works in Germany only for now. Collects offers and maps them to your Grocy products to be visible on your Grocy interface. Offers store the following information:
- store
- price
- product
- image
- whether you need app or card for the price to apply
- amount offered
- brand of product
- description
Offers shown on your Grocy server.
based on past consumption habits and current stock. It also collects offers to adjust your stock. It tells you to buy more or earlier of some product if the current offer price is lower than your history of purchases. Therefore saving you money. It will also find the cheapest store for a given product and recommend buying it there.
Grocy experimental view for shopping list management.
similar to Recipe Buddy.
However, this one will automatically prefill quantity units, amounts, and even products (if any are found in your database), leaving just a few checks here and there for you :). It does this by making a fuzzy search in your Grocy database and NLP processing to extract quantity data from the string.
Automatically collected data without any user intervention.
from some German stores:
- Lidl
- Kaufland
- Netto (they just changed their API from JSON to SOAP; it loads only old receipts)
- REWE (Not Stable)
- DM (Not stable)
So far.
The automatic prefilling of fields works here too.
Receipt form. The data on the screen is completely automatically generated.
data from OpenFoodFacts.



