v2.2 — Now with Profile Sync & Shot Annotations

MeticAI

Your AI Barista Coach for the Meticulous Espresso Machine

Meticulous Unleashed

Get Started
Capabilities

Everything You Need

From AI-powered profile creation to full machine control — MeticAI transforms how you brew.

AI Profile Creation

Snap a photo of your coffee bag or describe what you want. The AI creates a tailored espresso profile and uploads it to your machine — fully automatic.

Shot Analysis New

Dedicated shot analysis view with recent shots, by-profile grouping, and detailed pressure/flow/temperature curves.

AI Coaching

Get AI-powered coaching to improve your technique. Detailed analysis of every shot with actionable recommendations.

Profile Management New

Full catalogue with sync, rename, export, and orphan detection. Edit profiles directly — temperature, dose, and variables.

Control Center

Real-time temperature, pressure, and flow telemetry via MQTT. Start, stop, preheat, tare, and purge from any device.

Shot Annotations New

Rate every shot with stars and add markdown notes. Build a personal tasting journal linked to your shot data.

Machine Auto-Detect New

Automatic mDNS/Zeroconf discovery finds your Meticulous on the network. No manual IP entry needed.

Home Assistant

Built-in MQTT with auto-discovery. 24 sensors and 11 commands appear in Home Assistant automatically.

Latest Release

What’s New in v2.2

The biggest update yet — profile management, shot annotations, and machine auto-detection.

Profile Catalogue & Sync

Full profile management with two-way sync between MeticAI and your machine. Delete, rename, export, and detect orphaned profiles.

Shot Annotations

Rate every shot with 1–5 stars and add rich markdown notes. Your personal tasting journal, linked to every data point.

Shot Analysis View

Dedicated analysis interface with recent shots, by-profile grouping, and AI-powered insights into your brewing patterns.

Profile Editing

Edit profile names, temperatures, dose weights, and variables directly in the web interface. No more guessing.

Machine Auto-Detect

mDNS/Zeroconf discovery finds your Meticulous automatically. Just connect to your network and go.

AI Controls

Fine-tune AI behavior with auto-analyze toggles, AI visibility controls, and automatic description generation.

Interface

See It in Action

Setup

How It Works

MeticAI runs on a small computer in your home — like a Raspberry Pi, Mac, or Windows PC — and creates a private web app just for you.

1

Install

Run a one-line installer on Linux/macOS, PowerShell on Windows, or use the macOS app. Everything starts automatically.

2

Open the App

Access MeticAI from any phone, tablet, or computer on your home network. No app store — just your browser.

3

Snap & Brew

Take a photo of your coffee, pick taste tags, and let the AI create a tailored profile uploaded to your machine.

4

Control & Automate

Use the Control Center, schedule preheats, or integrate with Home Assistant and iOS Shortcuts.

Background

Why I Built This

The potential was (and is) basically limitless — my knowledge and time not so.

When I got my Meticulous, after a loooong wait, I was overwhelmed with the options — dialing in was no longer just adjusting grind size, the potential was (and is) basically limitless — my knowledge and time not so.

MeticAI is a growing set of AI tools to enable me, and you, to get the most out of a Meticulous Espresso machine. Among other things it lets you automatically create espresso profiles tailored to your preferences and coffee at hand, understand your espresso profiles and shot data like never before, and ultimately — lets you unleash your Meticulous.

Jesper, coffee nerd and MeticAI creator

Installation

Get Started in 5 Minutes

What You Need

  • A Meticulous Espresso Machine connected to your network
  • A server to run MeticAI (Raspberry Pi, Mac, Linux, or Windows PC)
  • A free Google Gemini API key → Get yours here

Installation

One-line install for Raspberry Pi, Linux, and macOS:

curl -fsSL https://raw.githubusercontent.com/hessius/MeticAI/main/scripts/install.sh | bash

Checks prerequisites, pulls the Docker image, and starts all services automatically.

View Full Documentation
Open Source

Credits & Acknowledgements

MeticAI is built on the excellent Meticulous MCP by twchad, meticulous-addon by nickwilsonr, and pyMeticulous by the Meticulous team.

Built With

  • Google Gemini 2.0 Flash — Vision AI
  • FastAPI + Uvicorn — Backend
  • React + TypeScript — Frontend
  • Docker + s6-overlay — Container
  • MQTT + Socket.IO — Telemetry
  • FastMCP — Machine API

MeticAI is open source and welcomes contributions!

View the code Report issues Contribute