Nyshporka

Liest Handschriften. Bringt Gefundenes.

Für Windows herunterladen Per Befehl installieren

Kostenlos und quelloffen (AGPL-3.0). Code auf GitHub

▶ Installation und erste Schritte — der Videokurs

Installationswege

Dieselbe App auf drei Wegen. Der Installer ist bequemer; die Befehle sind für Linux und macOS, für Server-Installationen und für alle, die sich im Terminal wohler fühlen.

Windows — eine Datei

ohne Python und ohne Administratorrechte

Starten, zwei Fragen beantworten, „Installieren“ klicken. Der Installer bringt einen eigenen Interpreter mit und legt alles im Benutzerprofil ab.

nyshporka-setup.exe

⚠ „Der Computer wurde durch Windows geschützt“ — „Weitere Informationen“ → „Trotzdem ausführen“. So begrüßt Windows jedes Programm, das erst wenige heruntergeladen haben. Die Datei können Sie mit der .sha256 neben dem Installer im Release prüfen.

Terminal — alle Systeme

ohne Python und ohne Administratorrechte

Ein Befehl auf einem frischen Rechner. Das Skript bringt uv mit, und uv einen eigenen Interpreter; ein Klon des Repositorys ist nicht nötig.

Windows (PowerShell)

irm https://raw.githubusercontent.com/SERGIUSH-UA/nyshporka/main/install/windows.ps1 -OutFile "$env:TEMP\nysh-install.ps1"
powershell -ExecutionPolicy Bypass -File "$env:TEMP\nysh-install.ps1"

Linux und macOS

curl -LsSf https://raw.githubusercontent.com/SERGIUSH-UA/nyshporka/main/install/unix.sh | sh

🔴 Wenn das Skript fertig ist, schließen Sie das Terminalfenster und öffnen Sie ein neues: Vorher wird der Befehl nysh darin nicht gefunden. Wird er auch im neuen nicht gefunden, starten Sie den Computer neu.

Python oder uv schon vorhanden

PyPI · Python 3.11+

Das Paket wird von PyPI installiert, GitHub ist dabei gar nicht nötig.

uv tool install "nyshporka[app,archives,htr]"   # oder: pip install "nyshporka[app,archives,htr]"
nysh init                      # Arbeitsordner anlegen
nysh doctor                    # Rechner prüfen
nysh serve                     # App im Browser öffnen

Leichtes Paket, ohne torch (~2,5 GB weniger): uv tool install "nyshporka[app,archives]". Updates: nysh update --check.

Um Handschriften zu lesen — noch zwei Schritte

Die Lesemodelle sind absichtlich nicht im Paket: Sonst würde jeder, der nur den Aktenkatalog ansehen will, mit Gigabytes dafür bezahlen. Die Schritte sind einmalig, und meist erledigt sie der Assistent; für die Archivkataloge sind sie nicht nötig.

nysh htr install    # Umgebung für die Lesemodelle, einmalig
nysh models get     # drei Lesemodelle, ~130 MB
nysh doctor         # die Prüfung „Рушії читання“ (Lesemodelle) muss grün werden

Wie Sie einen Assistenten verbinden, Komponentensätze und Optionen des Installers — „Assistenten installieren und verbinden“.

So sieht es aus

Die App öffnet sich in Ihrem Browser, läuft aber auf Ihrem Computer — auch ohne Internet.

Betrachter: der Scan, der gelesene Text und der Ausschnitt der Zeile, aus der er gelesen wurde.

Ortsverzeichnis: wo die Dokumente Ihres Dorfes liegen — über alle Bestände und Konfessionen hinweg, noch ohne einen einzigen Scan.

Suche: unscharfe Treffer, mit der Signatur der Akte und der Angabe, wie viel geprüft wurde.

Drei Lesemodelle

nysh models get lädt drei Modelle. Pysar und Diak lesen Kyrillisch und können an derselben Akte zusammenarbeiten — dann wird der Text aus ihren Stimmen zusammengeführt. Skryba liest Lateinschrift.

Pysar

Hauptstimme: Kanzleiakten, Kirchenbücher, Beichtlisten

Übernimmt die meisten kyrillischen Akten. Ist die Handschrift unleserlich, stützt sich das Modell darauf, wie solche Dokumente üblicherweise geschrieben wurden.

Diak

zweite Stimme: bleibt bei den Pixeln, wo die erste ergänzt

Liest dieselbe Schrift wie Pysar, bleibt aber näher an den Strichen selbst. Die beiden Stimmen werden abgeglichen: Wo sie auseinandergehen, lohnt ein Blick auf das Blatt.

Skryba

Lateinschrift: Notariatsakten und katholische Kirchenbücher

Eigene Schrift und eigenes Material: lateinische Einträge aus Notariatsakten und katholischen Kirchenbüchern, die die kyrillischen Modelle nicht lesen.

So funktioniert es

1 Installieren Sie Nyshporka und verbinden Sie einen KI-Assistenten (Agenten) — Claude Desktop, Claude Code oder Codex.
2 Sagen Sie dem Assistenten in einfachen Worten, wen Sie suchen: „hier sind Scans der Kirchenbücher von Chechelnyk, finde alle Kovalskyi“.
3 Der Assistent findet die Akten, liest die Blätter und sucht den Nachnamen.
4 Das Gefundene sehen Sie direkt auf dem Scan, mit Blattnummer, und entscheiden selbst, ob das Ihre Familie ist oder nicht.

Was zu Supriaha geht und was nicht

Geht nur mit Ihrer Zustimmung

Der gelesene Text und die Metadaten der Akte. Eine Akte mit 3772 Blättern wiegt im Paket 4–5 MB.

Geht nie

Die Scans selbst. Ihre Notizen, Funde und Ihr Stammbaum. Standardmäßig teilt die App nichts: Manche von uns haben für die Aufnahmen bezahlt.