KPAFI

KPAFI / MailDigest

MailDigest

Liest ein Spiegelpostfach, fasst jede Mail mit einem Sprachmodell zusammen, lässt eine zweite Instanz auf Phishing prüfen und schickt dir reinen Text auf Telegram, Discord oder Signal.

Installieren Quellcode auf GitHub

v0.3.1 MIT-Lizenz Beta Python 3.11+

Echtes PostfachWeiterleitung Spiegelpostfach MailDigest Messenger

Du siehst, was in deinem Posteingang passiert, ohne ihn zu öffnen. Nichts Klickbares erreicht dich.

Das Sicherheitsmodell in fünf Sätzen

  1. MailDigest bekommt nie Zugriff auf dein echtes Postfach, nur auf ein eigenes Spiegelpostfach. Dort löscht es nichts.

  2. Bevor ein Sprachmodell etwas sieht, reduziert deterministischer Code die Mail auf reinen Text: kein HTML, keine MIME-Teile, keine Anhänge.

  3. Die Sprachmodelle haben keine Werkzeuge, keinen Netzzugang und keinen Dateizugriff. Das Einzige, was sie erzeugen können, ist Text in einem validierten JSON-Feld.

  4. Was dich erreicht, hat Code ein letztes Mal geprüft: keine klickbaren Links, keine Anhänge, kein Markup. Domains erscheinen entschärft als example[.]com.

  5. Geht etwas schief, bekommst du eine Notiz statt ungeprüfter Inhalte. Nichts verschwindet still.

Die Pipeline

Deterministischer Code steht vor den Modellen und hinter ihnen.

  1. Code

    Ingest

    IMAP nur lesend, Gesehen-Flag, Deduplizierung

  2. Code

    Sanitizer

    MIME wird zu reinem Text. HTML, Links und Anhänge fliegen raus.

  3. LLM

    Summarizer

    Keine Werkzeuge, kein Netz, keine Dateien. Nur JSON-Ausgabe.

  4. LLM

    Critic

    Zweite Instanz mit eigenem Prompt: die Phishing-Prüfung

  5. Code

    Output-Check

    Keine Links, kein Markup, Domains entschärft

  6. Code

    Messenger

    Telegram, Discord oder Signal

Welches Sprachmodell

Keins / Standard

Du bekommst Auszüge. Alle Phishing-Warnungen funktionieren trotzdem, weil sie im Code berechnet werden.

Gratis-Kontingent

Groq, OpenRouter oder Cerebras. Ohne Kreditkarte.

Lokal

Ollama, LM Studio oder vLLM. Kein Mailinhalt verlässt die Maschine.

Anthropic

Kostenpflichtig. Der bereinigte Mailtext geht an den gewählten Anbieter.

Installieren

Debian 13+, Kali, Ubuntu 26.04+

curl -fsSL -o /tmp/maildigest-archive-keyring.gpg \
  https://kpafi.github.io/maildigest/apt/maildigest-archive-keyring.gpg \
  && sudo install -m 0644 /tmp/maildigest-archive-keyring.gpg /usr/share/keyrings/
echo "deb [signed-by=/usr/share/keyrings/maildigest-archive-keyring.gpg] https://kpafi.github.io/maildigest/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/maildigest.list
sudo apt update && sudo apt install maildigest

Fedora 43+

sudo dnf copr enable kpafi/maildigest
sudo dnf install maildigest

Überall sonst

pipx install maildigest

Docker / amd64 und arm64

mkdir -p maildigest/data && cd maildigest
curl -fsSLO https://raw.githubusercontent.com/kpafi/maildigest/main/docker-compose.yml
docker compose run --rm maildigest init

Danach

maildigest init
maildigest connect-mail
maildigest connect-llm        # optional
maildigest connect-messenger
maildigest test
maildigest instructions --edit
maildigest run

Mit Docker steht vor jedem Befehl docker compose run --rm.

Die Pakete sind auf Debian 13, Kali Rolling, Ubuntu 26.04 LTS und Fedora 43 bis Rawhide geprüft. Auf Ubuntu 24.04 und 25.04 nimmst du pipx.

Was du wissen solltest

Dokumentation