Skip to main content

Quick Start

Connect your Meticulous machine to the Hub with a single command.

Prerequisites​

  • A Meticulous espresso machine on your local network
  • A computer on the same network (macOS, Linux, or Windows)

One-Command Setup​

Open your terminal and run:

curl -fsSL https://api.meticuloushub.com/install.sh | sh

The installer will:

  1. Auto-discover your Meticulous machine on the network
  2. Guide you through creating an account (or signing in)
  3. Display a code to link your machine to your account
  4. Install and configure the Bridge agent

Approve the Connection​

When the installer displays an 8-character code:

  1. Go to app.meticuloushub.com/setup/approve
  2. Enter the code to link your machine
  3. Your device will appear in the dashboard

Start Using the Hub​

Once connected, you can:

  • Chat with AI - Open the dashboard and ask the assistant for profile recommendations
  • Snap a coffee bag - Upload a photo and get AI-generated extraction profiles
  • Track your shots - View history, compare to target profiles, dial in faster
  • Manage profiles - Save, organize, and load profiles to your machine

Optional: Connect Claude​

Power users can also control their machine through Claude Desktop or Claude.ai via MCP.

See the MCP Setup guide for details.

Manual Setup​

If you prefer to set things up manually, or the installer doesn't work for your environment:

Step 1: Create an Account​

  1. Go to app.meticuloushub.com
  2. Sign up with your email
  3. Verify your email address

Step 2: Register Your Device​

  1. In the dashboard, click Add Device
  2. Give your machine a name (e.g., "Kitchen Meticulous")
  3. Copy the Device Token - you'll need this for the Bridge

Step 3: Install the Bridge​

The Bridge is a lightweight agent that runs on your network and connects your machine to the Hub.

Using Docker​

docker run -d \
  --name meticulous-bridge \
  --restart unless-stopped \
  -e METICULOUS_DEVICE_TOKEN=mt_your_token_here \
  -e METICULOUS_SERVER_URL=wss://api.meticuloushub.com/bridge \
  -e METICULOUS_API_URL=http://your-machine-ip:8080 \
  ghcr.io/naticha/meticulous-bridge:latest

Direct Binary​

Download the latest release for your platform from GitHub Releases.

export METICULOUS_DEVICE_TOKEN=mt_your_token_here
export METICULOUS_SERVER_URL=wss://api.meticuloushub.com/bridge
export METICULOUS_API_URL=http://your-machine-ip:8080
./meticulous-bridge

Step 4: Verify Connection​

  1. Go back to the dashboard
  2. Your device should show as Online
  3. You should see the device info (firmware version, etc.)

Troubleshooting​

Device shows as Offline​

  • Check that the Bridge is running
  • Verify the device token is correct
  • Ensure the Bridge can reach your machine at the specified IP

Installer can't find my machine​

  • Make sure your machine is powered on and connected to the network
  • Try running the installer with the machine's IP address manually
  • Check that your computer is on the same network as the machine