Читає рукопис. Приносить знайдене.
Нишпорка допомагає шукати предків в архівних документах — метричних книгах, сповідних розписах, ревізіях XVIII–XIX століть. Але працює вона не так, як звичайна програма.
Роботу робить ШІ-помічник, вирішуєте ви. Помічникові на кшталт Claude чи ChatGPT можна дозволити працювати на вашому комп'ютері: відкривати теки, запускати програми, записувати результат — і щоразу питати дозволу. Такого помічника називають агентом, і Нишпорка зроблена саме для нього. Ви пишете звичайними словами: «ось тека зі сканами метричних книг Чечельника — знайди всіх Ковальських». Помічник читає рукописні аркуші, шукає прізвище й приносить знайдені рядки просто на скані. Чи це ваш рід — вирішуєте ви.
Що Нишпорка дає помічникові. Сам по собі він архівів не знає й старого рукопису не прочитає. Нишпорка дає йому знання, де що лежить (довідники архівів, описи фондів, перелік сіл і парафій), уміння читати рукопис (три власні моделі, навчені на українських, молдовських і польських архівах), пам'ять про переглянуте й правила чесної роботи: «не знайшов» завжди з поясненням, скільки аркушів переглянуто.
Чому це інший підхід. Звичайна програма вміє рівно те, що в неї заклали: скільки кнопок — стільки й можливостей. Нишпорка дає помічникові окремі вміння — знайти справу, прочитати аркуш, знайти прізвище, записати знахідку, — а він складає з них потрібне саме під ваше питання: «зроби таблицю всіх шлюбів у цьому селі за 1820-ті», хоч окремої кнопки для цього ніхто не робив. І що розумнішими стають помічники, то більше вміє Нишпорка — навіть без оновлення.
Не лише пошук прізвища. Нишпорка веде весь цикл: де шукати → скани → читання → пошук → облік переглянутого → акти таблицею → родовід із доказом до кожного факту → сайт роду з деревом, графом і мапою, де видно, хто де жив і коли. Родовід — звичайні файли на вашому диску, і жодна платформа їх не видалить. І досліджувати так можна не тільки рід, а й історію села, церкви, культури, біографію відомої людини. Як це влаштовано — від «де шукати» до звіту.
Що потрібно: комп'ютер (Windows, macOS або Linux), сама Нишпорка — безкоштовно, і помічник, що вміє працювати на комп'ютері: Claude Desktop (підписка Claude Pro або Max), Claude Code чи Codex. Керувати можна й з телефона — віддалено вести сесію помічника на комп'ютері із застосунку Claude чи Codex. Скани нікуди не йдуть — усе працює на вашій машині.
🎥 Подивитися наживо · 🤖 Поставити й підключити помічника · ⬇ Завантажити для Windows · як працювати · як це влаштовано
🎥 Як це працює, показано наживо — на стрімі «ШІ-агенти в генеалогії: дослідження майбутнього» («В гостях у Качки» №11). Перша частина — про те, навіщо генеалогові агент узагалі; сама Нишпорка в роботі — приблизно з 42-ї хвилини.
Що дістає агент
- 122 операції з описом і схемою.
nysh op <ім'я> --describeвіддає аргументи й повний докстрінг, нічого не виконуючи;nysh op <ім'я>виконує. Агентові досить самої команди; MCP-сервер прибрано в 0.19. - Скіли — готові процедури під задачу (
nysh skills list, ставитьnysh skills install— для Claude Code і Codex): як прочитати справу на слабкій машині, як шукати прізвище так, щоб нуль щось означав, куди копати далі, як прийняти куплену зйомку, як дотренувати модель на своєму почерку. - Правила, а не поради —
AGENTS.mdі для агентів: як читати нуль, чому «не наш рід» вирішує людина, і як агенти вже помилялися на цьому матеріалі, з цінами. - Одне ядро. Браузерна консоль і командний рядок — тонкі обгортки навколо одного реєстру операцій, тож вони не можуть розійтись у відповідях; це перевіряється тестом, а не домовленістю.
Ціна помилки тут інша, ніж у програмуванні, і середовище побудоване саме під неї: хибне «немає» закриває напрям пошуку назавжди, а хибне «є» йде в родовід і публікується як факт.
Що агент зробить вашими сканами
- Знайде, де лежать документи вашого села — газетир ЦДІАК (4566 поселень, 348 408 справ), поаркушевий покажчик плівок, каталог ДАХмО, церкви ~1772.
- Прочитає рукопис трьома рушіями:
[П]Писар (кирилиця, головний голос),[Д]Дяк (кирилиця, другий голос — тримається пікселів там, де перший додумує),[С]Скриба (латинка: нотаріат і костельні книги). - Покаже, звідки взявся текст — вирізка рядка з рамкою, сторінка, два голоси поруч.
- Шукатиме прізвище в прочитаному, у виписаних іменах і в учасниках записів.
- Вестиме облік переглянутого оком, щоб наступна сесія не гортала ті самі аркуші вдруге.
- Віддасть таблицею — розібрані акти в Ексель: фільтрувати роками, селом, станом і прізвищем.
- Складе родовід — картки осіб, родин, місць і джерел, до кожного факту вирізка зі скану; дерево з іншої програми засівається з GEDCOM.
- Збере сайт роду — сторінки осіб і родин, дерево, граф і мапа місць із фільтром за роками; відкрита версія сама прибирає живих.
Докладно, з межами кожного джерела — що вже працює.
Супряга: можливо, справу вже прочитано
Одну й ту саму архівну книгу сьогодні розпізнає кожен окремо, хоча текст виходить однаковий. Супряга — спільний банк прочитаних справ: що прочитав один, інший бере готовим за хвилину замість годин машинного часу.
- Їде текст, не зображення. Справа на кілька тисяч аркушів важить у пакеті 3–4 мегабайти; скани лишаються в того, хто їх завантажив.
- Узяти —
nysh share pull "ДАХмО 315-1-1234" --take, цілу серію —nysh share pull --repo RGIA --fond 592 --opys 25 --take. Прийняте одразу видно пошуку прізвища. - Що є в пулі —
nysh share pullбез запиту: огляд за архівами, фондами й описами. - Віддати своє —
nysh share packіnysh share publish; ділитися чи ні, вирішуєте ви, типово Нишпорка лише нагадує.
Чужий текст читала інша модель, тож «не знайшлось» у ньому важить менше, ніж у власному прогоні. Докладно — поділитися прочитаним.
Як це виглядає
Рішення лишається за оком, тож у Нишпорки є й власне обличчя в браузері: там людина дивиться те, що приніс агент. Без агента воно теж повне — просто всі кроки доводиться робити руками.
Видно, звідки взявся текст. Клацнувши рядок, ви бачите його вирізку з аркуша — у тому вигляді, у якому його бачив рушій.
Де взагалі метрики мого села. Газетир і покажчик плівок їдуть разом із пакетом і відповідають одразу після встановлення — без сканів, без відеокарти, без обходу чужих сайтів.
Видно, скільки перевірено. Пошук шукає нечітко, бо машина плутає літери всередині слова. А під знахідками написано, скільки справ і сторінок було переглянуто — щоб «нічого не знайшлось» не означало «просто ніде не шукали».
Поставити
🤖 Ставить агент? Дайте йому одне посилання — 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 у ньому не знайдеться. Якщо й у новому вікні не знаходиться —
перезапустіть комп'ютер. (Тим, хто ставив інсталятором, це не потрібно:
ярлики працюють одразу.)
Docker, без установки в систему. Готовий образ із рушіями й вагами:
docker run --rm ghcr.io/sergiush-ua/nyshporka doctor; для карти NVIDIA — тег
:cuda і --gpus all. Докладно —
«Нишпорка в Docker».
Якщо Python або uv уже є:
uv tool install "nyshporka[app,archives,htr]" # або: pip install …
nysh init # створити робочий простір
nysh doctor # перевірити те, що ламається тихо
nysh skills install # покласти скіли туди, де їх бачить агент
🔴 Щоб читати рукопис — ще два разові кроки. Самі рушії й навчені моделі в пакет не входять навмисно: інакше кожен, хто прийшов лише подивитись каталог справ, платив би за них гігабайтами.
nysh htr install # середовище рушіїв: kraken і PARSeq
nysh models get # ваги трьох моделей, ~225 МБ
Каталогам, газетиру й пошуку по описах вони не потрібні — ті працюють одразу.
На робочій машині розробника інсталятор нічого не переставляє; --dry-run
показує, що буде зроблено, а NYSH_NO_MODIFY_PATH=1 не чіпає PATH зовсім.
Важелі, набори частин, деінсталяція й те, де живе дослідження, —
встановлення докладно.
Стан: alpha
Каталоги, завантаження, читання рукопису, гортач, сховище прочитаного, пошук, браузерне обличчя й установлення працюють. Скани ви приносите самі; розбір актів у поля робить ваш агент і вашим коштом — пакет дає нарізку, контракт, валідацію й чексуми повноти, але сам не читає; а моделі читають добре той почерк, на якому вчились, — на іншому матеріалі якість не міряна. Повний перелік того, чого ще немає, без замовчувань — межі.
Далі
| поставити й підключити помічника, без термінала | Поставити й підключити помічника |
| що просити й як перевіряти знайдене | Як працювати |
| питання першого тижня і чого ще немає | Часті питання |
| взяти готовий текст справи або віддати свій | Поділитися прочитаним (Супряга) |
| дотренувати модель на своєму почерку | Дотренувати модель |
| прочитати справу на орендованій машині | Орендована машина |
| перша сесія агента, приймачі кроків | Для помічника й розробника |
| що змінилось у версіях | Що нового |
Приватність, ліцензія, участь
Телеметрії немає, облікових записів немає, дослідження нікуди не
вивантажується, а в мережу застосунок ходить лише тоді, коли його про це
попросили командою — PRIVACY.md.
Код — AGPL-3.0-or-later, ваги моделей — окремо, під CC BY-SA 4.0. Чому саме так, як підписується інсталятор і що звіряти при завантаженні — підписування й ліцензії.
Назви «Нишпорка» і «Супряга», логотип і маскот — позначення проєкту; ліцензії
коду й ваг прав на них не дають. Що можна без дозволу і що лише з ним —
TRADEMARKS.md.
Знайшли ваду або хочете допомогти — CONTRIBUTING.md і
Issues.
1 maintainer
Metadata
1 maintainer
Release files for nyshporka 0.30.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| nyshporka-0.30.0.tar.gz | 15.3 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nyshporka-0.30.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 26.7 MB
Release files / nyshporka-0.30.0.tar.gz
| Download URL | nyshporka-0.30.0.tar.gz |
|---|---|
| Size | 15.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
94b025309bcc53b28b4d9763fb99625385bf5cd9884c563209c67c1b6283e339
|
|
BLAKE2b-256 checksum How to use checksums |
883f8b800138d0f11768c19e96fed1a7d890e7ced072604782057c76132feb2a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / nyshporka-0.30.0-py3-none-any.whl
| Download URL | nyshporka-0.30.0-py3-none-any.whl |
|---|---|
| Size | 11.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8a477616ac228d592b4ac963f147da19f044b566f89a9a70bd4df2e64d1d7354
|
|
BLAKE2b-256 checksum How to use checksums |
1e1eef497256965a65f4e322b600b9dc207ca85066ab786a056c1295881d9e86
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logSecurity for nyshporka 0.30.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for nyshporka-0.30.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
