До вмісту
Нишпорка Увійти

Нишпорка

Читає рукопис. Приносить знайдене.

Безкоштовно, з відкритим кодом (AGPL-3.0). Код на GitHub

▶ Як поставити й з чого почати — відеоуроки

Способи встановлення

Той самий застосунок трьома шляхами. Інсталятор зручніший, команди — для Linux і macOS, для тих, хто ставить на сервер, і для тих, кому звичніше в терміналі.

Windows — один файл

без Python і без прав адміністратора

Запустити, відповісти на два питання, натиснути «Встановити». Інсталятор приносить власний інтерпретатор і кладе все в профіль користувача.

nyshporka-setup.exe

⚠ «Windows захистив ваш ПК» — «Докладніше» → «Виконати в будь-якому разі». Так Windows зустрічає кожну програму, яку ще мало хто завантажував. Звірити файл можна за .sha256 поруч із інсталятором у релізі.

Термінал — усі системи

без Python і без прав адміністратора

Однією командою на чистій машині. Скрипт приносить uv, а той — власний інтерпретатор; клон репозиторію не потрібен.

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 і macOS
curl -LsSf https://raw.githubusercontent.com/SERGIUSH-UA/nyshporka/main/install/unix.sh | sh

🔴 Коли скрипт завершить роботу, закрийте вікно термінала й відкрийте нове: доти команда nysh у ньому не знайдеться. Не знаходиться й у новому — перезапустіть комп'ютер.

Python або uv уже є

PyPI · Python 3.11+

Пакет ставиться з PyPI, GitHub при цьому не потрібен узагалі.

uv tool install "nyshporka[app,archives,htr]"   # або: pip install "nyshporka[app,archives,htr]"
nysh init                      # створити робочу теку
nysh doctor                    # перевірити машину
nysh serve                     # відкрити застосунок у браузері

Легкий набір, без torch (~2.5 ГБ менше): uv tool install "nyshporka[app,archives]". Оновлення: nysh update --check.

Щоб читати рукопис — ще два кроки

Моделі читання в пакет не входять навмисно: інакше кожен, хто прийшов лише подивитись каталог справ, платив би за них гігабайтами. Кроки разові, і зазвичай їх робить помічник; каталогам архівів вони не потрібні.

nysh htr install    # середовище для моделей читання, разово
nysh models get     # три моделі читання, ~130 МБ
nysh doctor         # перевірка «Рушії читання» має стати зеленою

Як підключити помічника, набори частин і важелі інсталятора — «Поставити й підключити помічника».

Як це виглядає

Застосунок відкривається у вашому браузері, але працює на вашому комп'ютері — без інтернету теж.

Гортач: скан, прочитаний текст і вирізка рядка, з якої його прочитано.
Гортач: скан, прочитаний текст і вирізка рядка, з якої його прочитано.
Газетир: де документи вашого села — по всіх фондах і конфесіях одразу, ще без жодного скана.
Газетир: де документи вашого села — по всіх фондах і конфесіях одразу, ще без жодного скана.
Пошук: нечіткі збіги з шифрою справи й тим, скільки перевірено.
Пошук: нечіткі збіги з шифрою справи й тим, скільки перевірено.

Три моделі читання

nysh models get приносить три моделі. Писар і Дяк читають кирилицю й на одній справі можуть працювати разом — тоді текст зводиться їхніми голосами. Скриба читає латинку.

Писар

головний голос: канцелярія, метрики, сповідки

Бере більшість кириличних справ. Коли рукопис нерозбірливий, спирається на те, як такі документи зазвичай писали.

Дяк

другий голос: тримається пікселів там, де перший додумує

Читає те саме письмо, що й Писар, але ближче до самих штрихів. Два голоси звіряють: де вони розходяться, варто глянути на аркуш.

Скриба

латинка: нотаріат і костельні книги

Окреме письмо й окремий матеріал: латинські записи нотаріату й костельних книг, яких кириличні моделі не беруть.

Спеціалісти

Кожен навчений на одному письмі: на своїх книгах читає краще за загальні моделі, на всіх інших — гірше. Самі не завантажуються: їх вмикають для конкретної справи.

Логофет

спеціаліст: румунська (молдавська) кирилиця Бессарабії

Метрики й клірові відомості Бессарабії 1810–1860-х, писані румунською кирилицею. Іде окремим голосом поруч із Писарем: російські записи й підписи причту читає Писар.

Регент

спеціаліст: руський канцелярський скоропис XVI–XVII ст.

Канцелярські книги й акти XVI–XVII століть, писані руським скорописом, який загальні моделі читають гірше.

Як це працює

  1. 1 Поставте Нишпорку й підключіть ШІ-помічника (агента) — Claude Desktop, Claude Code чи Codex.
  2. 2 Скажіть помічникові звичайними словами, кого шукаєте: «ось скани метричних книг Чечельника, знайди всіх Ковальських».
  3. 3 Помічник знаходить справи, читає аркуші й шукає прізвище.
  4. 4 Знайдене ви бачите просто на скані, з номером аркуша, і вирішуєте самі: ваш це рід чи ні.
Що їде в Супрягу, а що ні
Їде тільки за вашої згоди

Прочитаний текст і метадані справи. Справа на 3772 аркуші важить у пакеті 4–5 МБ.

Не їде ніколи

Самі скани. Ваші нотатки, знахідки й дерево. Типово застосунок не ділиться нічим: серед нас є ті, хто платив за зйомку.