Нишпорка

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

Нишпорка — робоче середовище для ШІ-агента в архівній генеалогії. Вона дає агентові руки: прочитати рукописну справу XVIII–XIX ст., знайти в прочитаному прізвище, дістати вирізку рядка зі скану, зібрати реєстр опису фонду, записати переглянуте так, щоб наступна сесія не переробляла те саме.

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

Чат на сайті цього не вміє: у нього немає доступу до вашого диска. Тому Нишпорка не сервіс і не передплата, а пакет, який ви ставите поруч зі своїм агентом — Claude Code, Claude Desktop або Codex. Усе лишається на вашій машині.

🤖 Підключити агента  ·  ⬇ Завантажити для Windows  ·  поставив — що далі

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

• 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.