Розбір відкритого репозиторію SERGIUSH-UA/nyshporka — HTR-читання рукописних архівних справ і пошук прізвища в них. Стенд показує маршрут, а не рекламу: чотири кроки, шість тихих зривів і критерій «зроблено».
Установлений пакет сам рукопис не читає — це головне непорозуміння цього репозиторію. Читання живе у двох окремих шарах, які ставляться окремими командами.
Або один файл-інсталятор під Windows, або uv tool install. Власний інтерпретатор Python 3.12 лягає в теку застосунку.
Ваші pyenv/conda/CUDA-збірки лишаються як були — перевіряю це до, а не після.
nysh init — тека, куди підуть скани, прочитане і покажчики. Вибираємо диск під обсяг плівок, а не «де стало».
Простір не знімається жодним прапорцем видалення — тому місце обираємо один раз і свідомо.
nysh htr install — окремий інтерпретатор з kraken і PARSeq. Це не той самий Python, що в кроці 1.
Без цього кроку nysh read відмовляє — і дізнатися про це посеред першої справи найгірше.
nysh models get — ваги трьох моделей, близько 130 МБ, зі звіркою контрольної суми.
У колесі пакета їх немає навмисно. Якщо звірка не збіглася — ставити не можна, і це видно одразу.
Критерій «зроблено» — не моє «все гаразд», а власна перевірка програми. До налаштування і після виглядає так:
$ nysh doctor # до налаштування
Робочий простір .......... відсутній
Довідники архівів ........ у комплекті
Рушії читання ............ немає середовища (kraken / PARSeq)
Ваги моделей ............. 0 з 3
Команда nysh у PATH ...... додано, потрібен новий термінал
$ nysh doctor # приймання
Робочий простір .......... готовий
Довідники архівів ........ у комплекті
Рушії читання ............ готові
Ваги моделей ............. 3 з 3, контрольні суми збіглися
Команда nysh у PATH ...... працює
Далі — пробна справа на ваших сканах: тека плівки → текст → пошук прізвища в прочитаному. Якщо прізвище знайшлося у справі, де ви знаєте, що воно там є, налаштування прийняте. Якщо ні — я показую, на якому з чотирьох шарів воно стало, і доводжу до результату.
| Що трапляється | Як виглядає для вас | Статус |
|---|---|---|
Команда nysh не знаходиться після встановлення | «Встановилось, а нічого не працює». Лікується новим вікном термінала або перезапуском — PATH не підхоплюється у вже відкритому вікні | часто |
| «Windows захистив ваш ПК» на інсталяторі | Схоже на вірус. Так Windows зустрічає кожну маловідому програму; перед запуском звіряю контрольну суму файлу з релізу | часто |
nysh read відмовляє, хоч програма стоїть | Не зроблені кроки 3 і 4. Це два різних шари, і жоден інсталятор їх за вас не зробить | блокує роботу |
| Ваги завантажилися, але контрольна сума не збіглася | Читання видає сміття замість тексту. Правильна реакція — перекачати, а не «спробувати так» | блокує роботу |
| Робочий простір на диску, де немає місця під плівки | Через два тижні скани нікуди не лізуть, а перенести простір уже боляче | дорого потім |
| Машина розробника: pyenv, conda, CUDA | Страх «мені зіпсують оточення». Режим сухого прогону показує зміни до того, як вони відбудуться; PATH можна не чіпати взагалі | керовано |
nysh doctor зелений повністю.