mirror of
https://github.com/Jeuners/agenttwo-tools.git
synced 2026-09-09 15:02:31 +02:00
docs: Voraussetzungen korrigieren (Node 22+, piper als Python-Modul)
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
This commit is contained in:
parent
799c9c9394
commit
e721540b80
2 changed files with 19 additions and 3 deletions
19
README.md
19
README.md
|
|
@ -17,16 +17,29 @@ npm-Workspace mit zwei Paketen:
|
||||||
|
|
||||||
## Voraussetzungen
|
## 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`)
|
- [Ollama](https://ollama.com) mit einem Qwen3-Modell (`ollama pull qwen3.5`)
|
||||||
- `ffmpeg` im `PATH`
|
- `ffmpeg` im `PATH`
|
||||||
- `whisper-cli` im `PATH` (whisper.cpp) inklusive Modell
|
- `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:
|
Unter macOS:
|
||||||
|
|
||||||
```bash
|
```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
|
### Whisper-Modell
|
||||||
|
|
|
||||||
|
|
@ -12,5 +12,8 @@
|
||||||
"dev:web": "npm run dev --workspace web",
|
"dev:web": "npm run dev --workspace web",
|
||||||
"typecheck": "npm run typecheck --workspaces --if-present",
|
"typecheck": "npm run typecheck --workspaces --if-present",
|
||||||
"start": "npm run build --workspace web && npm start --workspace server"
|
"start": "npm run build --workspace web && npm start --workspace server"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=22.5.0"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue