Нишпорка

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

Читання рукописних архівних справ і пошук прізвища в них — для генеалогів.

Комерційні OCR не читають скоропис XVIII–XIX ст., а платформи, які читають, платні й не мають моделей під матеріал українських, молдовських і польських архівів. Нишпорка закриває саме цю прогалину: беремо теку сканів із архіву й отримуємо текст, у якому можна шукати прізвище.

Стан: alpha

Каталоги, завантаження, читання рукопису, гортач, сховище прочитаного, пошук, браузерне обличчя й установлення працюють. Ваги трьох моделей ставляться командою nysh models get. Повний перелік того, чого немає, — у розділі «Чого ще немає» README, без замовчувань.

Поставити

На чистій машині — без Python і без прав адміністратора: інсталятор приносить uv, а uv приносить власний інтерпретатор.

WindowsТерміналPython уже є

:material-download: Завантажити інсталятор

Запустити, відповісти на два питання, натиснути «Встановити». Наприкінці майстра галочка «Запустити Нишпорку» відкриє застосунок у браузері.

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"

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

pip install 'nyshporka[app,archives,htr]'
nysh init      # створити робочий простір
nysh doctor    # перевірити те, що ламається тихо
nysh serve     # відкрити застосунок у браузері

Ставиться не все підряд: nysh init питає, чим ви користуватиметесь. Набір catalog — єдиний без torch (~2.5 ГБ), і саме він описує найпершого відвідувача: сканів ще немає, відеокарти теж, а питання вже є — «де взагалі метрики мого села».

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

Установлений пакет сам по собі рукопис не читає

Рушії живуть в окремому інтерпретаторі поруч із простором, а ваги приходять окремим релізом. Без цих кроків nysh read відмовляє з поясненням — але дізнатися про них посеред першої справи найгірший момент.

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

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

Три рушії читання

У кожного своя ділянка. У виводі вони помічені літерою — саме вона, а не колір, розрізняє їх у чорно-білому терміналі, у логах і при дальтонізмі.

	рушій	письмо	де працює
[П]	Писар	кирилиця	головний голос: канцелярія, метрики, сповідки
[Д]	Дяк	кирилиця	другий голос: тримається пікселів там, де перший додумує
[С]	Скриба	латинка	нотаріат і костельні книги

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

Чим тут міряють результат

Три правила, на яких стоїть усе решта. Вони не про зручність — кожне вже коштувало комусь роботи.

• Нуль без знаменника — не результат. Перед словом «немає» називається, чи читабельний декод, скільки сторінок прошукано і чи бачить конвеєр відомий позитив у цій самій справі. Хибне «немає» закриває напрям пошуку назавжди: людина більше не повернеться до цієї справи.
• Виявити ≠ перевірити. Машина подає кандидата з вирізкою рядка — вирішує око. Другий рушій не суддя там, де ознака в пікселях.
• Цифра з декоду — не факт. Суми, площі, кількість душ, дати звіряються із зображенням. Проза має за спиною мовну модель, багатозначне число — ні.

Політика підписування коду

Підписується один артефакт — інсталятор для Windows nyshporka-<версія>-setup.exe зі сторінки релізів. Він збирається виключно в GitHub Actions із тега, після воріт якості; ручної збірки в ланцюгу немає. Проєкт веде одна людина, тож ролі Author, Reviewer і Approver збігаються, і кожен підпис підтверджується вручну. Поруч із інсталятором лежить .sha256 для незалежної звірки.

Free code signing provided by SignPath.io, certificate by SignPath Foundation

Заявку подано, випуски ще не підписані

Доти Windows показує «Windows захистив ваш ПК» — це очікувано для програми, яку ще мало хто завантажував. Підпис прибере напис «Невідомий видавець», але саме попередження зникне лише з накопиченням репутації: Microsoft скасувала миттєве довір'я до сертифікатів, зокрема й EV.

Приватність

Телеметрії немає, облікових записів немає, дослідження нікуди не вивантажується, а в мережу застосунок ходить лише за прямою командою. Куди саме й навіщо — PRIVACY.md.

Куди далі

• Щойно поставив, застосунок порожній — «Поставив. Що далі?»: кроки від зразкової справи до першого прочитаного аркуша.
• Питання, що виникають першого тижня — часті питання: чи качати скани, чи можна їх потім видалити, вручну чи агентом, свій архів у переліку джерел.
• Працювати агентом у Нишпорці — перша сесія, далі як читати відповідь і як агенти вже помилялися.
• Що це за застосунок для людини — README.
• Правити сам пакет — CONTRIBUTING.

Числа беруться командою, а не звідси

Скільки справ у просторі, що вже прочитано, які моделі стоять — це nysh cases list, nysh doctor, nysh catalog packs. У документації лишаються тільки заміри, подані як заміри: з обставинами й причиною, чому вони щось означають.