Files
transkripte/LINUX_MIGRATION.md
T
2026-04-15 00:01:38 +02:00

85 lines
1.5 KiB
Markdown

# Linux Migration
Dieses Projekt kann auf einem Linux-Host ohne macOS-spezifische Bestandteile betrieben werden. Die Pipeline selbst ist plattformneutral; nur der Hintergrunddienst wechselt von `launchd` zu `systemd --user`.
## Voraussetzungen
- `python3` im `PATH`
- `ffprobe` im `PATH`
- `rclone` im `PATH`
- optional `fswatch`
- wenn `fswatch` nicht vorhanden ist, fällt die Pipeline automatisch auf Polling zurück
- eine funktionierende `rclone`-Remote `transkripte:/`
## Bundle erstellen
Auf dem Quellhost:
```bash
transcript bundle
```
Das erzeugt eine portable Datei in `dist/`, ohne:
- `.env`
- lokale Logs
- SQLite-State
- lokale Archive
## Auf dem Zielhost
1. Bundle kopieren und entpacken
```bash
tar -xzf whisper-transcript-pipeline-*.tar.gz
cd whisper-transcript-pipeline
```
2. Konfiguration anlegen
```bash
cp .env.example .env
```
3. `.env` anpassen
Mindestens diese Werte setzen:
- `OPENAI_API_KEY`
- `WATCH_DIR`
- `OBSIDIAN_DIR`
- optional `ARCHIVE_DIR`
- optional `PROMPT_PATH`
- optional `RCLONE_REMOTE`
4. Funktion lokal testen
```bash
python3 transcript_pipeline.py scan
```
5. Hintergrunddienst aktivieren
```bash
./bin/transcript install
./bin/transcript status
```
6. Logs prüfen
```bash
./bin/transcript logs pipeline
./bin/transcript logs service
```
## Wichtige Hinweise
- Der Linux-Dienst wird als `systemd --user` installiert.
- Wenn die Pipeline auch nach Logout weiterlaufen soll:
```bash
loginctl enable-linger "$USER"
```
- Die bisherigen macOS-spezifischen Dateien im Projekt können auf Linux ignoriert werden.