Harper Vollständiger Leitfaden: Rust-basierter Offline-Grammatikprüfer

Was ist Harper?

Harper ist ein Offline-Englisch-Grammatikprüfer, quelloffen von Automattic (der Muttergesellschaft von WordPress) und in Rust geschrieben. Auf GitHub hat das Projekt bereits 12.000+ Sterne gesammelt und trendet kontinuierlich.

Die Entstehung geht auf die Unzufriedenheit des Autors mit bestehenden Grammatikprüfungstools zurück:

• Grammarly: Teuer, gravierende Datenschutzprobleme (alles, was du schreibst, wird an ihre Server geschickt), und Vorschläge sind oft kontextlos
• LanguageTool: Zwar gut, braucht aber mehrere GB RAM und ~16 GB an n-gram-Datensätzen, was es langsamer macht

Harper positioniert sich als „just right" – schnell, leicht und datenschutzorientiert.

Warum brauchen Entwickler Harper?

Für Entwickler ist Harper besonders attraktiv wegen:

1. Datensicherheit: Code, API-Dokumentation, Tech-Blog-Entwürfe verlassen nie deinen Rechner
2. Millisekunden-Antwortzeit: Regelbasierte Engine, keine Netzwerkabhängigkeit
3. Native LSP-Unterstützung: harper-ls integriert sich in praktisch jeden LSP-fähigen Editor
4. Rust-Performance: Speicherverbrauch nur 1/50 von LanguageTool

Harper installieren

Harper bietet zahlreiche Nutzungsmöglichkeiten – vom Browser bis zur IDE.

Methode 1: Direkt im Browser

Der einfachste Weg – besuche writewithharper.com. Die Seite läuft über WebAssembly lokal im Browser, ohne Registrierung, ohne Internetverbindung. Einfach Text einfügen und prüfen.

Methode 2: harper-ls installieren (Language Server)

harper-ls ist die Kern-Engine von Harper und stellt über das LSP-Protokoll Grammatikprüfungen für verschiedenste Editoren bereit.

Über cargo installieren (empfohlen)

cargo install harper-ls

Nach der Installation überprüfen:

harper-ls --version

Über Binärdownload

Harper bietet vorkompilierte Binärdateien. Lade einfach die passende ausführbare Datei von den GitHub Releases herunter:

# Linux-Beispiel
wget https://github.com/Automattic/harper/releases/latest/download/harper-ls-x86_64-unknown-linux-gnu.tar.gz
tar -xzf harper-ls-x86_64-unknown-linux-gnu.tar.gz
sudo mv harper-ls /usr/local/bin/

Editor-Integration in der Praxis

VS Code

1. Suche im VS Code Marketplace nach Harper
2. Installiere das harper-ls Plugin
3. Öffne eine beliebige Markdown- oder Textdatei – die Grammatikprüfung startet automatisch

// optionale Konfiguration in settings.json
{
  "harper-ls.dialect": "American",
  "harper-ls.markdown.ignore": ["code", "inlineCode"]
}

Obsidian

Harper hat ein dediziertes Plugin für Obsidian:

1. Suche in Obsidians Community Plugins nach Harper
2. Aktiviere das Plugin
3. Während des Schreibens werden Grammatikfehler mit roten Wellenlinien markiert

Für chinesische Entwickler, die englische Tech-Dokumentation (z. B. READMEs, API-Dokumentation) schreiben, ist das eine äußerst praktische Kombination.

Neovim

Konfiguration über lspconfig:

-- Nach Installation über Mason
require('lspconfig').harper_ls.setup({
  settings = {
    ["harper-ls"] = {
      dialect = "American",
      userDictPath = ""  -- optional: benutzerdefinierter Wörterbuchpfad
    }
  }
})

Helix

Harper unterstützt Helix nativ. Füge in ~/.config/helix/languages.toml folgendes hinzu:

[[language]]
name = "markdown"
language-servers = ["harper-ls"]

Emacs / Zed

Ebenfalls LSP-fähig. Siehe offizielle Dokumentation.

Fortgeschrittene Nutzung

Benutzerdefinierter Dialekt

Harper unterstützt verschiedene englische Dialekte:

{
  "dialect": "British"   // American | British | Canadian | Australian | Indian
}

Bestimmte Bereiche ignorieren

In Markdown-Dokumenten kannst du Abschnitte per Kommentar von der Prüfung ausschließen:

<!-- harper: ignore -->
This is code-related text that shouldn't be checked.
<!-- harper: end -->

CLI-Prüfung (harper-cli)

Für die Integration in CI/CD-Pipelines kannst du harper-cli nutzen:

# Installieren
cargo install harper-cli

# Einzelne Datei prüfen
harper-cli check README.md

# Alle Markdown-Dateien in einem Verzeichnis prüfen
harper-cli check docs/

# JSON-Ausgabe (ideal für CI-Integration)
harper-cli check --format json docs/ > report.json

Beispielausgabe:

README.md:42:5 - "their" should be "there"
README.md:87:12 - Missing article before "documentation"

Einsatz in GitHub Actions

name: Grammar Check
on: [push, pull_request]

jobs:
  harper:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Harper
        run: cargo install harper-cli
      - name: Check docs
        run: harper-cli check docs/ --format json > report.json

Harper vs. LanguageTool – Leistungsvergleich

Harper setzt auf eine Regel-Engine + Wörterbuch-Architektur und verzichtet auf große statistische Modelle. Das bedeutet: Die Abdeckungsrate ist nicht so umfassend wie bei Grammarly, aber für Tech-Dokumentation, Blogs und E-Mails reicht es locker aus.

Für wen ist Harper geeignet?

✅ Empfohlen

• Englische Tech-Blog-Autoren: Code-Snippets werden niemals in die Cloud hochgeladen
• Nicht-muttersprachliche Entwickler: Schnelle Prüfung englischer Dokumente auf Grammatikfehler
• Datenschutzbewusste Nutzer: Alles läuft komplett lokal ab
• CI/CD-Pipelines: Automatische Dokumentationsprüfung via harper-cli

⚠️ Noch nicht geeignet

• Chinesische Grammatikprüfung (derzeit nur Englisch unterstützt)
• Tiefe semantische Analyse und Stilvorschläge (Harper arbeitet regelbasiert, ohne KI-gestützte Stilberatung)
• Team-Kollaboration (noch kein gemeinsames Wörterbuch verfügbar)

Fazit

Harper ist ein präzise positioniertes Open-Source-Grammatikprüfungstool: leichtgewichtig, schnell und datenschutzorientiert. Es wird Grammarly im professionellen Schreibbereich nicht ersetzen, aber für Entwickler, die regelmäßig Dokumente, Blogs oder E-Mails schreiben, ist es mehr als ausreichend.

Wichtige Infos auf einen Blick:

Wenn du die Datenschutzprobleme von Grammarly satt hast und LanguageTool zu schwerfällig findest, ist Harper definitiv einen Versuch wert.