Me and a couple of friends have been building a wine cellar app for a while called Cellarion.app Since my house runs on Home Assistant it was only a matter of time before the two had to talk to each other, so I wrote a custom integration for it, and after using it at home for a while I think it’s ready to share.
Full disclosure: we’re the team behind Cellarion, and the integration is mine. Everything is open source, the integration is MIT and Cellarion itself is AGPL. The easiest way is the hosted service at cellarion.app (free account), but if you prefer to keep everything at home you can run Cellarion in your own Docker, the integration works the same against both.
What you get in HA:
Sensors for the whole collection: bottle count, value, drink window buckets (at peak, declining, not ready and so on), health score, how many years your cellar will last at current pace
A dashboard card that comes bundled with the integration, no separate install. It shows a “Ready to drink” list sorted by which window closes first, and a “Drink soon” list for bottles on their way down. Every bottle has a small consume button, so when you grab one from the rack you tap it and it’s logged
A cellarion.consume_bottle action for automations. I have NFC tags on some rack slots, scan when I take the bottle and it’s logged without touching a screen
Updates are close to realtime. The integration keeps an SSE connection open to the server, so when you add or drink a bottle the sensors update after a few seconds. Nothing to configure, no ports to open, and it falls back to normal polling if the server doesn’t support it
Login is done with a scoped API token, your password is never stored in HA. Older setups migrate to a token automatically
It’s tested against HA 2024.4 and up (CI runs hassfest, the HACS checks and a test suite on every change). Would be happy to hear what you think, and if you have ideas for automations around wine I’m all ears.
Thanks for the share, looks really nice Would be cool to add the Cellarion app itself as an app in HA so it could be easily installed in HA if you use HAOS
I think it is better to have them apart. The wine Cellar app in its own docker (if you want to host it your self) else and easier is to use the cellarion.app (it is total free). And then just get the alert and some layout in ha with the custom component.
That is how we designed it. Cellarion is primary a wine cellar app and we opened up so we can use it for a custom component and the user self in ha can script and do stuff with the data if they like.
The way you did it may even invite someone to come along and write an LLM plug-in for thier system for your integration and the modularity works… Just sayin…
Its just special case inventory and we already do that so…
That is amazing! I’m headed to Sonoma for a week in a couple of months with a several close friends - I will point them towards your app! this is right up their alley!
Would be cool to add the Cellarion app itself as an app in HA so it could be easily installed in HA if you use HAOS 
