Installieren und den Assistenten verbinden¶

Der Hauptweg kommt ohne einen einzigen Befehl aus: drei Programme in der richtigen Reihenfolge und eine fertige Anfrage. Das dauert 30–40 Minuten, den größten Teil davon der Download.

Warum nicht der Chat auf der Website

Im Chat auf claude.ai oder chatgpt.com funktioniert Nyshporka nicht: Der Chat antwortet mit Text und hat keinen Zugriff auf Ihre Festplatte. Nötig ist ein Assistenzprogramm, das sich genauso unterhält wie der Chat, aber selbst Aktionen auf dem Computer ausführt und vor jeder um Erlaubnis bittet.

Dasselbe als Video

Die Lektionen 3–5 der Videoreihe zeigen die Installation unter Windows Schritt für Schritt. Der Assistent im Video ist Codex (siehe „Andere Assistenten“ unten); mit Claude Desktop ist die Reihenfolge dieselbe: Git, Nyshporka, Assistent, Arbeitsordner, fertige Anfrage. Die Lektionen sind auf Ukrainisch, mit Untertiteln, die YouTube in Ihre Sprache übersetzt.

Was Sie brauchen¶

Windows 10 oder 11, macOS oder Linux.
Etwa 5 GB freien Platz: Die Lesemodelle und alles, was sie brauchen — 2.5 GB.
Ein Abo Claude Pro oder Max — für Claude Desktop (Tarife). Oder ein ChatGPT-Abo — für Codex. Nyshporka selbst ist kostenlos: Sie zahlen nur für den Assistenten.

Schritt 1. Git for Windows¶

Laden Sie Git for Windows herunter und installieren Sie es, indem Sie überall auf „Next“ klicken. Ohne Git öffnet sich in Claude Desktop der Reiter Code nicht, und Nyshporka braucht es, um die Lesemodelle zu installieren. Unter macOS ist Git meist schon vorhanden.

Schritt 2. Nyshporka installieren¶

Nyshporka wird nach Git installiert: ohne Git lässt sich das Lesemodul für Handschriften nicht installieren. Der Assistent kommt zuletzt (warum — in Schritt 3).

WindowsmacOS und Linux

Installationsprogramm herunterladen und starten.
Wenn Windows meldet „Der Computer wurde durch Windows geschützt“ — „Weitere Informationen“ → „Trotzdem ausführen“. So begrüßt Windows jedes Programm, das bisher nur wenige heruntergeladen haben.
Wählen Sie auf der Seite «Де жити Нишпорці» (Wo Nyshporka wohnen wird) einen Ordner auf einem Laufwerk mit viel Platz (etwa 10 GB nötig), zum Beispiel D:\Genealogy\Nyshporka. In diesem einen Ordner liegt alles: das Programm, die Lese-Engines und Ihre Recherche.
Lassen Sie bei der Frage «Що ставимо» (Was installieren wir) «Усе (рекомендовано)» (Alles, empfohlen) stehen. Das leichte Paket enthält nur die Archivkataloge, ohne Lesen von Handschrift und ohne Familiensuche.
Lassen Sie am Ende beide Häkchen gesetzt: «Запустити Нишпорку» (Nyshporka starten) öffnet die Anwendung im Browser (das ist Ihr Computer, keine Website: Sie funktioniert auch ohne Internet), das zweite öffnet diese Anleitung beim nächsten Schritt.

Öffnen Sie das „Terminal“, fügen Sie eine Zeile ein und drücken Sie Enter:

curl -LsSf https://raw.githubusercontent.com/SERGIUSH-UA/nyshporka/main/install/unix.sh | sh

Wenn das Skript fertig ist, schließen Sie das Terminalfenster.

Schritt 3. Claude Desktop¶

Laden Sie die Anwendung herunter: Windows, macOS.
Starten Sie sie und melden Sie sich bei Ihrem Konto an.
Klicken Sie oben in der Mitte auf den Reiter Code.

Wenn Claude schon auf dem Computer installiert war

Schließen Sie es vollständig — Rechtsklick auf das Symbol neben der Uhr → «Beenden» (Quit) — und öffnen Sie es erneut. Das Programm merkt sich beim Start, wo es nach Befehlen suchen soll, und weiß daher nichts von der gerade installierten Nyshporka. Symptom: Der Assistent schreibt, dass der Befehl nysh nicht gefunden wurde.

Schritt 4. Den Arbeitsordner öffnen¶

Im Reiter Code, bevor Sie etwas schreiben:

Wählen Sie Local — der Assistent arbeitet dann auf Ihrem Computer.
Select folder → der Ordner, den Sie im Installationsprogramm auf der Seite «Де жити Нишпорці» (Wo Nyshporka wohnen wird) gewählt haben, standardmäßig Документи\Нишпорка (der Ordner „Нишпорка“ unter „Dokumente“). Dort werden Scans, Gelesenes und Notizen liegen. Falls Sie vergessen haben, wo er ist: Der Pfad steht unten auf der Startseite der Anwendung.
Berechtigungsmodus — Manual: Der Assistent fragt vor jeder Aktion, und Sie sehen, was genau er tut.

Schritt 5. Die fertige Anfrage einfügen¶

Kopieren Sie den Text vollständig in das Eingabefeld und drücken Sie Enter:

Lies https://raw.githubusercontent.com/SERGIUSH-UA/nyshporka/main/AGENTS.md
Sag mir zuerst kurz, was Nyshporka ist und was wir jetzt tun werden.
Dann erledige gemäß der Anleitung alles, damit Nyshporka auf diesem Computer bereit ist: Prüfe
den Rechner, installiere bei Bedarf die Lese-Engines und Modelle und lege die Skills für alle
Projekte ab. Erkläre mir jeden Schritt in einfachen Worten.
Wenn alles grün ist, frag mich, welchen Nachnamen ich suche und in welchen Schreibweisen.

Der Assistent liest die für ihn geschriebene Anleitung und wird, jedes Mal mit der Bitte um Erlaubnis:

den Rechner prüfen (nysh doctor);
die Lesemodelle installieren (nysh htr install, nysh models get) — das ist der längste Schritt, etwa 2.5 GB;
die Skills ablegen — fertige Arbeitsabläufe (nysh skills install --user);
fragen, welchen Nachnamen wir suchen.

Fertig ist es, wenn der Assistent sagt, dass die Prüfung keine roten Zeilen hat, und nach dem Nachnamen fragt. Weiter geht es mit „So arbeiten Sie“.

Andere Assistenten¶

Codex (OpenAI, ChatGPT-Abo): Anwendung oder Version für das Terminal. Die Schritte 1 und 2 sind dieselben; öffnen Sie in Schritt 4 den Ordner Документи\Нишпорка; schreiben Sie in der Anfrage statt „lege die Skills für alle Projekte ab“ „lege die Skills im Ordner ~/.agents/skills ab“.

Claude Code im Terminal — eine Zeile und der Start genügen:

nysh skills install --user   # скіли для всіх проєктів
claude

Andere — jeder Assistent, der Skills im Format SKILL.md liest (Agent Skills), darunter OpenClaw. So legen Sie sie in seinen Ordner: nysh skills install --target <тека>.

Wenn etwas nicht stimmt¶

Was Sie sehen	Was zu tun ist
Assistent: „Befehl `nysh` nicht gefunden“	Claude vollständig schließen (Symbol neben der Uhr → Beenden) und erneut öffnen. Im Terminal ein neues Fenster öffnen; hilft das nicht, den Computer neu starten
Der Reiter Code bietet an, den Tarif zu wechseln	Nötig ist ein Abo Claude Pro oder Max
Assistent: „Umgebung der Lese-Engines nicht bereit“	Sagen Sie ihm: „Installiere die Lese-Engines und Modelle“
Assistent: „torch lädt nicht“, „Visual C++ fehlt“	Sagen Sie ihm: „Installiere die Lese-Engines“. Nyshporka installiert die Komponente Microsoft Visual C++ — Windows fragt nach Administratorrechten, stimmen Sie zu
Der Assistent sieht den Ordner mit den Scans nicht	Der Ordner liegt außerhalb des Arbeitsordners; der Assistent muss um Erlaubnis bitten, ihn in die Buchführung aufzunehmen (`nysh roots add`). Dateien werden nirgendwohin verschoben
Das Installationsprogramm endete mit „Code 1“	Sehen Sie sich die letzten Zeilen der Ausgabe an. Meist ist es ein abgebrochener Download, zu wenig Platz oder ein Virenschutz
Etwas anderes	Dem Autor schreiben und wörtlich anfügen, was der Assistent geschrieben hat

Ohne Assistenten oder mit Python¶

Wenn Python oder uv schon vorhanden ist, wird das Paket von PyPI installiert:

uv tool install "nyshporka[app,archives,htr]"   # або: pip install "nyshporka[app,archives,htr]"
nysh init                      # створити робочу теку
nysh doctor                    # перевірити машину
nysh serve                     # відкрити застосунок у браузері
nysh htr install               # середовище для моделей читання, разово
nysh models get                # моделі читання, ~225 МБ, разово

Ein einzeiliges Installationsprogramm für Windows ohne Python — in 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"

Für Fortgeschrittene: Pakete, Schalter des Installationsprogramms, wo die Forschung liegt

Pakete. nysh init fragt, was Sie nutzen werden; ändern lässt sich das jederzeit mit nysh sections, ohne Neuinstallation.

Paket	Was enthalten ist
`catalog`	Kataloge, Ortsverzeichnis, Findbücher der Bestände — ohne Lesemodelle, spart ~2.5 GB
`amateur`	+ Lesen von Handschrift und Betrachter
`researcher` (Standard)	+ Suche im Gelesenen, Buchführung, Export
`lab`	+ Zeilenauszeichnung und Nachtrainieren von Modellen (`nysh train`)

Schalter. Gleich für Skripte und .exe:

Was wir festlegen	`windows.ps1`	`unix.sh`	`.exe`
Paket	`-Preset catalog`	`NYSH_PRESET=catalog`	`/PRESET=catalog`
Zusammensetzung des Pakets komplett	`-Source 'nyshporka[app,archives]'`	`NYSH_SOURCE=…`	—
bestimmte Version	`-Version X.Y.Z`	über `NYSH_SOURCE`	in die Datei eingebaut
ein Ordner für alles	`-Workspace D:\Genealogy\Nyshporka -Home_ D:\Genealogy\Nyshporka\.program`	—	`/WORKSPACE=D:\Genealogy\Nyshporka`
bestehende Installation verschieben	`nysh relocate D:\Genealogy\Nyshporka`	ebenso	ebenso
ohne Rückfragen	—	—	`/VERYSILENT`
ohne Paket der Nachschlagewerke	`-NoCatalog`	`NYSH_NO_CATALOG=1`	—
Protokoll	—	—	`/LOG=setup.log`
wo die Forschung liegt	`NYSHPORKA_WORKSPACE`	`NYSHPORKA_WORKSPACE`	`NYSHPORKA_WORKSPACE`

⚠ irm … | iex funktioniert für das Windows-Skript nicht (die Datei hat ein UTF-8-BOM) — erst -OutFile, dann -File.

Entwicklerrechner. Das Installationsprogramm installiert nichts um: uv und ein eigenes Python 3.12 kommen in den Ordner der Anwendung, pyenv, conda und CUDA-Builds bleiben, wie sie waren. Außerhalb der eigenen Ordner gibt es nur einen Eintrag in PATH. sh -s -- --dry-run zeigt die Änderungen und tut nichts, NYSH_NO_MODIFY_PATH=1 lässt PATH unangetastet. Die Liste der Änderungen landet in install-trace.txt.

Wo die Forschung liegt. Der Arbeitsordner (in Befehlen — Arbeitsbereich):

nysh init D:/Дослідження                      # обрати місце при створенні
export NYSHPORKA_WORKSPACE=D:/Дослідження     # закріпити для всіх команд
nysh --workspace D:/Дослідження doctor        # разово

Ohne die Variable suchen die Befehle nyshporka.toml vom aktuellen Ordner aus nach oben. Wohin die Anwendung gerade schaut — nysh doctor, Zeile «Робочий простір» (Arbeitsbereich).

Mac mit Intel-Prozessor. Wird wie überall installiert; nysh htr install nimmt Python und torch aus conda-forge, weil PyPI dafür keine torch-Wheels neuer als 2.2.2 hat.

Eine Grafikkarte ist nicht nötig. Ohne sie wird eine Seite in ~20 s – 1 Min. gelesen (je nach Prozessor und danach, wie viele Zeilen die Seite hat), mit Karte in ~10–15 s. Die Beschleunigung per Karte ist ein eigener Schritt, den nysh doctor vorschlägt.