From e721540b8020270b84fc6d0e5853fa67d4b3bdd7 Mon Sep 17 00:00:00 2001
From: Jeuner <62662523+Jeuners@users.noreply.github.com>
Date: Wed, 26 Aug 2026 17:16:17 +0200
Subject: [PATCH] docs: Voraussetzungen korrigieren (Node 22+, piper als
 Python-Modul)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Beim Testen eines frischen Clones fielen zwei falsche Angaben auf:

- "Node.js 20+" stimmte nicht. db.ts nutzt node:sqlite, das unter Node 20
  gar nicht existiert (ERR_UNKNOWN_BUILTIN_MODULE) — der Server startet dort
  nicht. Ab 22 läuft es, mit ExperimentalWarning; stabil ab Node 24.
  Zusätzlich als engines-Feld in package.json hinterlegt.
- "brew install piper" führte in die Irre: voice.ts ruft `python3 -m piper`
  auf, nicht das Homebrew-Binary. Korrekt ist `pip3 install piper-tts`.

Dazu ein Prüf-Snippet, mit dem sich die Toolchain vor dem ersten Start
verifizieren lässt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S1NXUpHbxTusqQmsjrFfbU
---
 README.md    | 19 ++++++++++++++++---
 package.json |  3 +++
 2 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index b465f7b..ac98442 100644
--- a/README.md
+++ b/README.md
@@ -17,16 +17,29 @@ npm-Workspace mit zwei Paketen:
 
 ## Voraussetzungen
 
-- Node.js 20+
+- **Node.js 22+** — `server/src/db.ts` nutzt das eingebaute `node:sqlite`,
+  das es unter Node 20 noch nicht gibt. Unter Node 22 erscheint beim Start
+  eine `ExperimentalWarning`; ab Node 24 ist das Modul stabil.
 - [Ollama](https://ollama.com) mit einem Qwen3-Modell (`ollama pull qwen3.5`)
 - `ffmpeg` im `PATH`
 - `whisper-cli` im `PATH` (whisper.cpp) inklusive Modell
-- `piper` im `PATH`
+- Piper als **Python-Modul** — der Server ruft `python3 -m piper` auf,
+  nicht das gleichnamige Homebrew-Binary
 
 Unter macOS:
 
 ```bash
-brew install ffmpeg whisper-cpp piper
+brew install ffmpeg whisper-cpp
+pip3 install piper-tts
+```
+
+Prüfen, ob alles bereitsteht:
+
+```bash
+ffmpeg -version >/dev/null 2>&1 && echo "ffmpeg OK"
+whisper-cli --help >/dev/null 2>&1 && echo "whisper-cli OK"
+python3 -m piper --help >/dev/null 2>&1 && echo "piper OK"
+node -e "require('node:sqlite')" 2>/dev/null && echo "node:sqlite OK"
 ```
 
 ### Whisper-Modell
diff --git a/package.json b/package.json
index 1969555..7883a72 100644
--- a/package.json
+++ b/package.json
@@ -12,5 +12,8 @@
     "dev:web": "npm run dev --workspace web",
     "typecheck": "npm run typecheck --workspaces --if-present",
     "start": "npm run build --workspace web && npm start --workspace server"
+  },
+  "engines": {
+    "node": ">=22.5.0"
   }
 }