Aller au contenu
Nyshporka Se connecter

Nyshporka

Lit les manuscrits. Rapporte ce qu'elle trouve.

Gratuit, en code source ouvert (AGPL-3.0). Le code sur GitHub

▶ Comment l'installer et par où commencer — leçons vidéo

Modes d'installation

La même application, de trois façons. Le programme d'installation est plus pratique ; les commandes sont pour Linux et macOS, pour ceux qui installent sur un serveur et pour ceux qui sont plus à l'aise dans un terminal.

Windows — un seul fichier

sans Python ni droits d'administrateur

Lancez-le, répondez à deux questions, cliquez sur « Installer ». Le programme d'installation apporte son propre interpréteur et place tout dans le profil de l'utilisateur.

nyshporka-setup.exe

⚠ « Windows a protégé votre ordinateur » — « Informations complémentaires » → « Exécuter quand même ». C'est ainsi que Windows accueille tout programme encore peu téléchargé. Vous pouvez vérifier le fichier grâce au .sha256 placé à côté du programme d'installation dans la page de la version.

Terminal — tous les systèmes

sans Python ni droits d'administrateur

Une seule commande sur une machine vierge. Le script installe uv, qui apporte à son tour son propre interpréteur ; inutile de cloner le dépôt.

Windows (PowerShell)
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"
Linux et macOS
curl -LsSf https://raw.githubusercontent.com/SERGIUSH-UA/nyshporka/main/install/unix.sh | sh

🔴 Quand le script a terminé, fermez la fenêtre du terminal et ouvrez-en une nouvelle : jusque-là, la commande nysh n'y sera pas trouvée. Si elle reste introuvable dans la nouvelle fenêtre, redémarrez l'ordinateur.

Python ou uv déjà installé

PyPI · Python 3.11+

Le paquet s'installe depuis PyPI ; GitHub n'est alors pas du tout nécessaire.

uv tool install "nyshporka[app,archives,htr]"   # ou : pip install "nyshporka[app,archives,htr]"
nysh init                      # créer un dossier de travail
nysh doctor                    # vérifier la machine
nysh serve                     # ouvrir l'application dans le navigateur

Version légère, sans torch (~2,5 Go de moins) : uv tool install "nyshporka[app,archives]". Mise à jour : nysh update --check.

Pour lire les manuscrits — encore deux étapes

Les modèles de lecture ne font volontairement pas partie du paquet : sinon, quiconque vient seulement consulter le catalogue des dossiers les paierait en gigaoctets. Ces étapes ne se font qu'une fois, et c'est généralement l'assistant qui s'en charge ; les catalogues d'archives n'en ont pas besoin.

nysh htr install    # environnement pour les modèles de lecture, une seule fois
nysh models get     # trois modèles de lecture, ~130 Mo
nysh doctor         # la vérification « Рушії читання » (moteurs de lecture) doit passer au vert

Comment connecter l'assistant, les ensembles de composants et les options du programme d'installation — « Installer et connecter l'assistant ».

À quoi ça ressemble

L'application s'ouvre dans votre navigateur, mais fonctionne sur votre ordinateur — même sans Internet.

La visionneuse : le scan, le texte lu et l'extrait de ligne à partir duquel il a été lu.
La visionneuse : le scan, le texte lu et l'extrait de ligne à partir duquel il a été lu.
Le répertoire géographique : où se trouvent les documents de votre village — dans tous les fonds et toutes les confessions à la fois, avant même le moindre scan.
Le répertoire géographique : où se trouvent les documents de votre village — dans tous les fonds et toutes les confessions à la fois, avant même le moindre scan.
La recherche : correspondances approximatives, avec la cote du dossier et l'étendue de ce qui a été vérifié.
La recherche : correspondances approximatives, avec la cote du dossier et l'étendue de ce qui a été vérifié.

Trois modèles de lecture

nysh models get installe trois modèles. Pysar et Diak lisent le cyrillique et peuvent travailler ensemble sur un même dossier — le texte est alors établi à partir de leurs deux voix. Skryba lit l'alphabet latin.

Pysar

voix principale : écrits de chancellerie, registres paroissiaux, listes de confession

Prend en charge la plupart des dossiers en cyrillique. Quand le manuscrit est illisible, il s'appuie sur la façon dont ces documents étaient habituellement rédigés.

Diak

deuxième voix : s'en tient aux pixels là où la première extrapole

Lit la même écriture que Pysar, mais au plus près des traits eux-mêmes. Les deux voix sont comparées : là où elles divergent, il vaut la peine de regarder le feuillet.

Skryba

alphabet latin : actes notariés et registres catholiques

Une écriture et un matériau à part : les actes latins du notariat et des registres catholiques, que les modèles cyrilliques ne prennent pas en charge.

Comment ça marche

  1. 1 Installez Nyshporka et connectez un assistant IA (un agent) — Claude Desktop, Claude Code ou Codex.
  2. 2 Dites à l'assistant avec des mots ordinaires qui vous cherchez : « voici les scans des registres paroissiaux de Chechelnyk, trouve tous les Kovalskyi ».
  3. 3 L'assistant trouve les dossiers, lit les feuillets et cherche le nom de famille.
  4. 4 Vous voyez les trouvailles directement sur le scan, avec le numéro du feuillet, et vous décidez vous-même s'il s'agit de votre famille.
Ce qui part vers Supriaha, et ce qui n'y part pas
Part seulement avec votre accord

Le texte lu et les métadonnées du dossier. Un dossier de 3772 feuillets pèse 4 à 5 Mo dans le paquet.

Ne part jamais

Les scans eux-mêmes. Vos notes, vos trouvailles et votre arbre. Par défaut, l'application ne partage rien : certains d'entre nous ont payé pour la prise de vue.