61 lines
2.0 KiB
Markdown
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.
|