Repository navigation
Home
TranQuiL edited this page Jun 11, 2026
·
3 revisions
Welcome to the official documentation for the Grocy Home Assistant Overhaul.
This Wiki is your complete guide to installing the bulletproof backend, configuring the Optimistic UI frontend, and building futuristic automations like AI Receipt Scanning and NFC Smart Pantries.
- Installation Guide: Step-by-step instructions for deploying via HACS, including both the Python backend and the JavaScript Command Center.
- Dashboard Configuration: Advanced Lovelace YAML configurations, grid column adjustments, and layout options for mobile vs. tablet displays.
- The NFC Smart Pantry: How to bind physical NFC/RFID tags to Grocy actions using Home Assistant automations.
- AI Receipt Vision Scanner: Instructions for wiring up Google Gemini or OpenAI to automatically read your grocery receipts and restock your database.
- Architecture & The Optimistic UI: A deep dive into how the frontend eliminates polling lag and the backend executes Direct API Strikes.
- Troubleshooting & FAQ: Solutions for network blips, pygrocy crashes, and how to read your Home Assistant error logs.
If you have followed the Installation Guide and are still running into issues with "ghost items" or stuck buttons:
- Check the Troubleshooting page first.
- If your issue persists, please open a detailed ticket on our Issues Tracker.
Tip: Always make sure your base Grocy server (the actual application, whether running as an Add-on or in Docker) is fully updated before troubleshooting the Home Assistant integration!