Hermes

Lightweight email importance assistant for Raspberry Pi 4.

Polls Gmail, scores emails with a local LLM (Ollama), and sends push notifications via ntfy for the ones that matter.

How it works

• Gmail API (read-only OAuth2) fetches new emails every 5 minutes
• Ollama (qwen2.5:0.5b) scores each email's importance using a structured JSON prompt
• SQLite stores email metadata and drives the processing pipeline
• ntfy delivers push notifications for important emails
• Few-shot examples from user feedback improve scoring over time

Modes

• Training — Interactive CLI on Mac for labeling emails and calibrating the scorer
• Live — systemd daemon on Raspberry Pi, runs autonomously after ~50-100 labeled emails

Status

Architecture and design complete. Implementation not yet started.