nyshporka 0.18.1

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

Нишпорка допомагає шукати предків в архівних документах — метричних книгах, сповідних розписах, ревізіях XVIII–XIX століть. Але працює вона не так, як звичайна програма.

Роботу робить ШІ-помічник, вирішуєте ви. Помічникові на кшталт Claude чи ChatGPT можна дозволити працювати на вашому комп'ютері: відкривати теки, запускати програми, записувати результат — і щоразу питати дозволу. Такого помічника називають агентом, і Нишпорка зроблена саме для нього. Ви пишете звичайними словами: «ось тека зі сканами метричних книг Чечельника — знайди всіх Ковальських». Помічник читає рукописні аркуші, шукає прізвище й приносить знайдені рядки просто на скані. Чи це ваш рід — вирішуєте ви.

Що Нишпорка дає помічникові. Сам по собі він архівів не знає й старого рукопису не прочитає. Нишпорка дає йому знання, де що лежить (довідники архівів, описи фондів, перелік сіл і парафій), уміння читати рукопис (три власні моделі, навчені на українських, молдовських і польських архівах), пам'ять про переглянуте й правила чесної роботи: «не знайшов» завжди з поясненням, скільки аркушів переглянуто.

Чому це інший підхід. Звичайна програма вміє рівно те, що в неї заклали: скільки кнопок — стільки й можливостей. Нишпорка дає помічникові окремі вміння — знайти справу, прочитати аркуш, знайти прізвище, записати знахідку, — а він складає з них потрібне саме під ваше питання: «зроби таблицю всіх шлюбів у цьому селі за 1820-ті», хоч окремої кнопки для цього ніхто не робив. І що розумнішими стають помічники, то більше вміє Нишпорка — навіть без оновлення.

Що потрібно: комп'ютер (Windows, macOS або Linux), сама Нишпорка — безкоштовно, і помічник, що вміє працювати на комп'ютері: Claude Desktop (підписка Claude Pro або Max), Claude Code чи Codex. Скани нікуди не йдуть — усе працює на вашій машині.

🎥 Подивитися наживо  ·  🤖 Поставити й підключити помічника  ·  ⬇ Завантажити для Windows  ·  як працювати

🎥 Як це працює, показано наживо — на стрімі «ШІ-агенти в генеалогії: дослідження майбутнього» («В гостях у Качки» №11). Перша частина — про те, навіщо генеалогові агент узагалі; сама Нишпорка в роботі — приблизно з 42-ї хвилини.

Що дістає агент

• 122 операції з описом і схемою. nysh op <ім'я> --describe віддає аргументи й повний докстрінг, нічого не виконуючи; nysh op <ім'я> виконує. Через це MCP не обов'язковий — агентові з терміналом досить самої команди.
• 18 MCP-tool'ів — nysh mcp install прописує сервер у .mcp.json проєкту. Перелік навмисно вужчий за реєстр операцій: у нього є стеля, за якою модель перестає читати описи й починає вгадувати.
• 11 скілів — готових процедур під задачу (nysh skills install): як прочитати справу на слабкій машині, як шукати прізвище так, щоб нуль щось означав, куди копати далі, як прийняти куплену зйомку, як дотренувати модель на своєму почерку.
• Правила, а не поради — AGENTS.md і для агентів: як читати нуль, чому «не наш рід» вирішує людина, і як агенти вже помилялися на цьому матеріалі, з цінами.
• Три обличчя, одне ядро. Браузерна консоль, командний рядок і MCP — тонкі обгортки навколо одного реєстру операцій, тож вони не можуть розійтись у відповідях; це перевіряється тестом, а не домовленістю.

Ціна помилки тут інша, ніж у програмуванні, і середовище побудоване саме під неї: хибне «немає» закриває напрям пошуку назавжди, а хибне «є» йде в родовід і публікується як факт.

Що агент зробить вашими сканами

• Знайде, де лежать документи вашого села — газетир ЦДІАК (4566 поселень, 348 408 справ), поаркушевий покажчик плівок, каталог ДАХмО, церкви ~1772.
• Прочитає рукопис трьома рушіями: [П] Писар (кирилиця, головний голос), [Д] Дяк (кирилиця, другий голос — тримається пікселів там, де перший додумує), [С] Скриба (латинка: нотаріат і костельні книги).
• Покаже, звідки взявся текст — вирізка рядка з рамкою, сторінка, два голоси поруч.
• Шукатиме прізвище в прочитаному, у виписаних іменах і в учасниках записів.
• Вестиме облік переглянутого оком, щоб наступна сесія не гортала ті самі аркуші вдруге.
• Віддасть таблицею — розібрані акти в Ексель: фільтрувати роками, селом, станом і прізвищем.

Докладно, з межами кожного джерела — що вже працює.

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

Рішення лишається за оком, тож у Нишпорки є й власне обличчя в браузері: там людина дивиться те, що приніс агент. Без агента воно теж повне — просто всі кроки доводиться робити руками.

Видно, звідки взявся текст. Клацнувши рядок, ви бачите його вирізку з аркуша — у тому вигляді, у якому його бачив рушій.

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

Видно, скільки перевірено. Пошук шукає нечітко, бо машина плутає літери всередині слова. А під знахідками написано, скільки справ і сторінок було переглянуто — щоб «нічого не знайшлось» не означало «просто ніде не шукали».

Поставити

🤖 Ставить агент? Дайте йому одне посилання — AGENTS.md. Там і встановлення, і перші кроки, і межі, за якими вирішує людина.

👤 Ставите самі, без термінала? Покрокова інструкція — три програми в правильному порядку й один готовий запит — «Поставити й підключити помічника».

Windows. ⬇ Завантажити інсталятор — запустити, відповісти на два питання, натиснути «Встановити». Python, прав адміністратора й термінала не треба.

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

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

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

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

Якщо Python або uv уже є:

uv tool install "nyshporka[app,archives,htr]"   # або: pip install …
nysh init                      # створити робочий простір
nysh doctor                    # перевірити те, що ламається тихо
nysh mcp install               # прописати сервер агентові
nysh skills install            # покласти скіли туди, де їх бачить агент

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

nysh htr install    # середовище рушіїв: kraken і PARSeq
nysh models get     # ваги трьох моделей, ~130 МБ

Каталогам, газетиру й пошуку по описах вони не потрібні — ті працюють одразу.

На робочій машині розробника інсталятор нічого не переставляє; --dry-run показує, що буде зроблено, а NYSH_NO_MODIFY_PATH=1 не чіпає PATH зовсім. Важелі, набори частин, деінсталяція й те, де живе дослідження, — встановлення докладно.

Стан: alpha

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

Далі

Приватність, ліцензія, участь

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

Код — AGPL-3.0-or-later, ваги моделей — окремо, під CC BY-SA 4.0. Чому саме так, як підписується інсталятор і що звіряти при завантаженні — підписування й ліцензії.

Знайшли ваду або хочете допомогти — CONTRIBUTING.md і Issues.