Files
jarvis-voice-companion/README.md
T

61 lines
2.0 KiB
Markdown

# 🎙️ Jarvis Desktop Voice Companion (Linux / Hyprland)
Ein autonomer, leichtgewichtiger Desktop Voice Buddy für Linux (Hyprland, Arch, Debian, Ubuntu).
Reagiert lokal auf das **Wake Word („Hey Jarvis“)**, zeichnet deine Sprache auf und spricht über das OpenClaw Gateway direkt als dein persönlicher Co-Pilot.
---
## 🚀 Features
- **Local Wake Word Detection:** Verwendet `openWakeWord` (100% lokal, datenschutzfreundlich, 0ms Cloud-Latenz).
- **OpenClaw Gateway Sync:** Direkte WebSocket-Verbindung zu deinem Jarvis Gateway (`ws://<gateway-host>:18789`).
- **Neural Text-to-Speech (TTS):** Hochwertige deutsche Sprachausgabe via `edge-tts` / `Piper TTS` / `Kokoro`.
- **Desktop Status Indicator:** Minimalistische Tray-Anzeige & Floating Status (🟢 Standby | 🎙️ Höre zu... | 🧠 Nachdenken... | 🔊 Spreche...).
- **Hyprland & Waybar Integration:** Eigene Keybindings (z. B. `Super + V` für manuellen Voice-Trigger) & System-Notifications via `notify-send`.
---
## 🛠️ Installation
### 1. Repository klonen & Abhängigkeiten installieren
```bash
git clone http://gitea.pepe44.dev/Pepe44DEV/jarvis-voice-companion.git ~/.config/jarvis-voice-companion
cd ~/.config/jarvis-voice-companion
chmod +x install.sh
./install.sh
```
### 2. Konfiguration anpassen
Erstelle deine `config.json` aus der Vorlage:
```bash
cp config.json.template config.json
nano config.json
```
Trage dort deine OpenClaw Gateway-URL (z. B. `ws://10.0.1.10:18789`) und deinen Auth-Token ein.
### 3. Starten
```bash
# Manuell starten:
python3 companion.py
# Oder als Systemd User Service aktivieren:
systemctl --user enable --now jarvis-companion.service
```
---
## ⌨️ Hyprland Keybinding Setup
Füge folgendes zu deiner `~/.config/hypr/hyprland.conf` hinzu:
```ini
# Jarvis Voice Companion Manual Trigger (Super + V)
bind = $mainMod, V, exec, python3 ~/.config/jarvis-voice-companion/companion.py --trigger-now
```
---
## 📜 Lizenz
MIT License. Entwickelt für Pascal (@pepe) & das OpenClaw-Ökosystem.