Your personal wine cellar - beautifully organized

Track your collection with AI-powered label recognition, Vivino integration, and a stunning 3D globe.
Run as a Home Assistant add-on or standalone Docker container.

Install on Home Assistant Run with Docker

Why Wine Tracker?

Built for privacy, designed for simplicity, driven by the community.

Local First

Everything runs on your Home Assistant or Docker. No cloud, no subscription, no data sharing. Your wine cellar stays yours - always.

AI - Optional & Affordable

Snap a label photo → AI fills in everything, including maturity phases, taste profile and food pairings. Choose from six providers: Anthropic Claude, OpenAI, OpenRouter, MiniMax, Mistral, or Ollama (free, local) - set up right in the app, no config files. A typical label analysis runs about 2,500 tokens, so a hosted provider costs cents per wine - and Ollama is free.

Community Driven

Built by wine lovers, for wine lovers. Feature requests, feedback, and contributions are always welcome. Join us on GitHub or the HA Community forum.

See it in action

A beautiful, responsive interface designed for wine lovers. Works seamlessly on desktop and mobile.

Wine Cellar Overview

Wine Tracker - Statistics with Globe & Charts

Statistics & 3D Globe

Add Wine - AI, Vivino or Manual

Everything you need to manage your cellar

From AI-powered label recognition to interactive globe visualization - Wine Tracker has you covered.

Wine Cards

Beautiful cards with photo, producer, vintage, type, region, grape variety, alcohol, star rating, and personal tasting notes. Tap the bottle badge to correct the count, with five seconds to undo.

AI Label Recognition

Snap a photo of any wine label and let AI fill in all fields automatically - including maturity phases, taste profile and food pairings. Supports Claude, GPT, OpenRouter, Ollama, MiniMax, and Mistral.

Vivino Search

Search by name, see community ratings, regions, and prices. Import wine data directly into your collection - with a regional fallback chain that surfaces country-specific labels too.

Interactive Globe

See your wine regions on a beautiful 3D WebGL globe. A stunning way to visualize your collection geographically.

Statistics

Donut charts, stock history, total bottles, total liters, collection value, and average age - all at a glance.

AI Sommelier

Ask for food pairings, serving temperature, and recommendations. Upload label photos and add, edit or delete wines directly from the conversation.

AI Setup in the App

Pick your provider, paste the API key and run a connection test - all from the settings modal, no YAML editing. Keys are stored write-only and never shown again, and only admins can change them.

7 Languages

Full support for German, English, French, Italian, Spanish, Portuguese, and Dutch.

Docker Standalone

Run without Home Assistant. Simple Docker Compose setup with persistent data volumes.

User Authentication

Built-in login with admin and readonly roles. Secure your collection with multi-user support.

REST API

The /api/summary endpoint returns your total bottle count and a breakdown by wine type as JSON - ready to feed Home Assistant sensors and dashboards.

Star Ratings

Rate your wines from 1 to 5 stars. Filter and sort by your personal ratings.

Maturity Graph

Visualize your wine's drinking window with an interactive maturity curve. Know exactly when each bottle is at its peak.

Timeline

Track every addition, edit, and tasting in a chronological activity log. See your cellar's full history at a glance.

Taste Profile & Pairings

AI-generated taste profiles with body, tannin, acidity, and sweetness. Get food pairing suggestions for every wine.

Four View Modes

Switch between Cards, List, Grid, and a sortable Table view with persistent sort direction - whichever fits the moment.

Six Themes

Home Assistant, Classic, Vineyard, Champagne, Slate and Burgundy - each with its own dark and light mode. Your pick is stored per user on the server, so it follows you across browsers and devices - along with the view mode, table sort and filter defaults.

Advanced Filter

Combine multiple AND-conditions across any field - type, vintage, region, grape, rating, drink window, location and more - in a single popover. Save your favourite combinations as named presets and re-apply them with one click.

Out-of-Stock Tracking

Wines that hit zero bottles stay in your cellar with an "Empty" ribbon instead of disappearing. A persistent setting remembers whether you want to see them, with a quick toggle in the filter bar.

Backup & Restore

Export your whole collection - wines, ratings, timeline and images - as a single ZIP, and import it back (or a CSV) with a duplicate-matching preview before anything is written.

Quick Start with Docker

Up and running in under a minute. No Home Assistant required.

Three simple steps

Create a docker-compose.yml file with the configuration shown here
Run docker compose up -d to start the container
Open http://localhost:5050 in your browser and log in

All data is stored in a Docker volume - your collection survives container updates.

View full configuration on GitHub

docker-compose.yml

services:
  wine-tracker:
    image: ghcr.io/xenofex7/wine-tracker:1.11.0
    ports:
      - "5050:5050"
    volumes:
      - wine-data:/data
    environment:
      - AUTH_ENABLED=true
      - USERS=admin:changeme
      - SECRET_KEY=change-this-to-a-random-string
      - CURRENCY=CHF
      - LANGUAGE=de
    restart: unless-stopped

volumes:
  wine-data:

Home Assistant Add-on

Seamless integration with your smart home. Install directly from the add-on store.

Click the button above or manually add the repository URL: https://github.com/xenofex7/ha-wine-tracker
Wine Tracker will appear in your add-on store. Click Install
Start the add-on - it opens in your HA sidebar under Wine Tracker