Nyshporka

Czyta rękopis. Przynosi znaleziska.

Pobierz dla Windows Zainstaluj poleceniem

Bezpłatnie, z otwartym kodem (AGPL-3.0). Kod na GitHubie

▶ Jak zainstalować i od czego zacząć — lekcje wideo

Sposoby instalacji

Ta sama aplikacja na trzy sposoby. Instalator jest wygodniejszy, polecenia — dla Linux i macOS, dla tych, którzy instalują na serwerze, i dla tych, którym wygodniej w terminalu.

Windows — jeden plik

bez Pythona i bez uprawnień administratora

Uruchom, odpowiedz na dwa pytania, kliknij „Встановити” („Zainstaluj”). Instalator ma własny interpreter i umieszcza wszystko w profilu użytkownika.

nyshporka-setup.exe

⚠ „System Windows ochronił ten komputer” — „Więcej informacji” → „Uruchom mimo to”. Tak Windows wita każdy program, który pobrało jeszcze niewiele osób. Plik można zweryfikować za pomocą .sha256 obok instalatora w wydaniu.

Terminal — wszystkie systemy

bez Pythona i bez uprawnień administratora

Jednym poleceniem na czystym komputerze. Skrypt pobiera uv, a ten — własny interpreter; klon repozytorium nie jest potrzebny.

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 i macOS

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

🔴 Gdy skrypt zakończy pracę, zamknij okno terminala i otwórz nowe: do tego czasu polecenie nysh nie będzie w nim dostępne. Jeśli nie ma go także w nowym — uruchom ponownie komputer.

Masz już Pythona lub uv

PyPI · Python 3.11+

Pakiet instaluje się z PyPI, GitHub nie jest przy tym w ogóle potrzebny.

uv tool install "nyshporka[app,archives,htr]"   # lub: pip install "nyshporka[app,archives,htr]"
nysh init                      # utwórz folder roboczy
nysh doctor                    # sprawdź komputer
nysh serve                     # otwórz aplikację w przeglądarce

Lekki zestaw, bez torch (~2,5 GB mniej): uv tool install "nyshporka[app,archives]". Aktualizacja: nysh update --check.

Aby czytać rękopisy — jeszcze dwa kroki

Modele odczytu celowo nie wchodzą w skład pakietu: inaczej każdy, kto przyszedł tylko przejrzeć katalog jednostek, płaciłby za nie gigabajtami. Kroki są jednorazowe i zwykle wykonuje je asystent; do katalogów archiwów nie są potrzebne.

nysh htr install    # środowisko dla modeli odczytu, jednorazowo
nysh models get     # trzy modele odczytu, ~130 MB
nysh doctor         # test „Рушії читання” (silniki odczytu) powinien zmienić kolor na zielony

Jak podłączyć asystenta, zestawy komponentów i opcje instalatora — „Instalacja i podłączenie asystenta”.

Jak to wygląda

Aplikacja otwiera się w Twojej przeglądarce, ale działa na Twoim komputerze — także bez internetu.

Przeglądarka skanów: skan, odczytany tekst i wycinek wiersza, z którego go odczytano.

Skorowidz miejscowości: gdzie są dokumenty Twojej wsi — we wszystkich zespołach i wyznaniach naraz, jeszcze bez żadnego skanu.

Wyszukiwanie: przybliżone dopasowania z sygnaturą jednostki i informacją, ile sprawdzono.

Trzy modele odczytu

nysh models get pobiera trzy modele. Pysar i Diak czytają cyrylicę i mogą pracować razem nad jedną jednostką — wtedy tekst powstaje z ich głosów. Skryba czyta alfabet łaciński.

Pysar

główny głos: pismo kancelaryjne, metryki, spisy spowiedzi

Radzi sobie z większością jednostek cyrylickich. Gdy rękopis jest nieczytelny, opiera się na tym, jak zwykle pisano takie dokumenty.

Diak

drugi głos: trzyma się pikseli tam, gdzie pierwszy dopowiada

Czyta to samo pismo co Pysar, ale bliżej samych kresek. Dwa głosy są porównywane: tam, gdzie się rozchodzą, warto zajrzeć do karty.

Skryba

alfabet łaciński: akta notarialne i księgi rzymskokatolickie

Osobne pismo i osobny materiał: łacińskie zapisy akt notarialnych i ksiąg rzymskokatolickich, z którymi modele cyrylickie sobie nie radzą.

Jak to działa

1 Zainstaluj Nyshporkę i podłącz asystenta AI (agenta) — Claude Desktop, Claude Code lub Codex.
2 Powiedz asystentowi zwykłymi słowami, kogo szukasz: „oto skany ksiąg metrykalnych z Czeczelnika, znajdź wszystkich Kowalskich”.
3 Asystent znajduje jednostki, czyta karty i szuka nazwiska.
4 Znaleziska widzisz wprost na skanie, z numerem karty, i to Ty decydujesz, czy to Twój ród.

Co trafia do Supriahy, a co nie

Trafia tylko za Twoją zgodą

Odczytany tekst i metadane jednostki. Jednostka z 3772 kartami zajmuje w pakiecie 4–5 MB.

Nie trafia nigdy

Same skany. Twoje notatki, znaleziska i drzewo. Domyślnie aplikacja niczego nie udostępnia: są wśród nas tacy, którzy zapłacili za wykonanie skanów.