Skip to content
mxkissnr edited this page May 25, 2026 · 4 revisions

Language: English | Deutsch

Gaggiuino Local Profiler — Documentation

Local shot profiling dashboard for Gaggiuino-based espresso machines. Syncs shots automatically, visualizes extraction profiles, and provides a real-time live view — all from Home Assistant.

Pages

Architecture How add-on, integration, and Lovelace card work together
Features Full feature list
Installation & Configuration Setup, options, smart plug
Usage Shot archive, live mode, compare, fullscreen
Shot Score How the 0–100 score is calculated
Analytics Score trend, calendar heatmap, bean stats, profile performance
Coffee Library Bean and grinder database with autocomplete
Exports .shot export, CSV export
Compatibility Supported firmware and hardware
Data & Security Storage layout, API endpoints, security model

GLP Ecosystem

GLP consists of three components — install all three for the full experience:

Component Description Install
GLP Add-on Core — shot storage, web UI, REST API This add-on
GLP HA Integration HA sensors, events, automations HACS
GLP Lovelace Card Machine status card for your dashboard HACS

→ See Architecture for a full diagram and explanation.

Quick start

  1. Add the repository to Home Assistant: Settings → Add-ons → Add-on Store → ⋮ → Repositories
  2. Install Gaggiuino Local Profiler
  3. Set machine_url to your controller's API URL (e.g. http://192.168.1.42/api/shots)
  4. Start the add-on and open the dashboard via Open Web UI
# Verify connectivity from the HA terminal first:
curl http://<gaggiuino-ip>/api/shots/latest

Links

Clone this wiki locally