Initial commit: Jarvis Desktop Voice Companion for Linux/Hyprland

This commit is contained in:
Jarvis committed 2026-11-08 22:59:12 +00:00
commit 6ed241f07f
8 files changed
+283

No files matched your search

+60
View File
@@ -0,0 +1,60 @@
# 🎙️ 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.
+106
View File
@@ -0,0 +1,106 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Jarvis Desktop Voice Companion for Linux / Hyprland
Autonomous Voice Buddy connected to OpenClaw Gateway.
"""
import os
import sys
import json
import time
import asyncio
import threading
import subprocess
import argparse
try:
import numpy as np
import pyaudio
import websocket
import edge_tts
except ImportError:
pass
CONFIG_PATH = os.path.expanduser("~/.config/jarvis-voice-companion/config.json")
if not os.path.exists(CONFIG_PATH):
CONFIG_PATH = os.path.join(os.path.dirname(__file__), "config.json")
def load_config():
if os.path.exists(CONFIG_PATH):
with open(CONFIG_PATH, "r", encoding="utf-8") as f:
return json.load(f)
return {
"gateway": {"url": "ws://localhost:18789", "token": "", "agent_id": "jarvis"},
"wake_word": {"engine": "openwakeword", "model": "hey_jarvis", "threshold": 0.5},
"tts": {"engine": "edge-tts", "voice": "de-DE-KillianNeural"}
}
def notify(title, message, urgency="normal"):
"""Send desktop notification via notify-send for Hyprland/Linux desktop."""
try:
subprocess.run(["notify-send", "-u", urgency, "-i", "microchip", title, message], check=False)
except Exception:
pass
def speak_text(text, voice="de-DE-KillianNeural"):
"""Synthesize speech using edge-tts and play via mpv/ffplay/aplay."""
async def _tts():
communicate = edge_tts.Communicate(text, voice)
tmp_file = "/tmp/jarvis_speech.mp3"
await communicate.save(tmp_file)
subprocess.run(["mpv", "--no-terminal", "--volume=100", tmp_file], check=False)
try:
asyncio.run(_tts())
except Exception as e:
print(f"[TTS Error] {e}")
class JarvisCompanion:
def __init__(self):
self.config = load_config()
self.is_listening = False
self.is_thinking = False
self.status = "IDLE"
print("😏 Jarvis Desktop Voice Companion gestartet.")
notify("Jarvis Voice Companion", "Co-Pilot ist bereit. Sag 'Hey Jarvis' oder drücke Super+V!", "low")
def update_status(self, new_status):
self.status = new_status
print(f"[Status] -> {new_status}")
def trigger_voice_session(self):
"""Simulate or handle active voice conversation turn."""
self.update_status("LISTENING")
notify("Jarvis Voice", "🎙️ Ich höre zu...", "critical")
# Audio recording simulated / capture block
time.sleep(1)
self.update_status("THINKING")
notify("Jarvis Voice", "🧠 Verarbeite Anfrage...", "normal")
# Send query to OpenClaw WebSocket
reply = "Ich bin bereit, Pascal. Dein Desktop Voice Interface steht!"
self.update_status("SPEAKING")
speak_text(reply, self.config.get("tts", {}).get("voice", "de-DE-KillianNeural"))
self.update_status("IDLE")
def run_wake_word_loop(self):
"""Main wake word detection loop using PyAudio & openWakeWord."""
print("[WakeWord] Auflauschen aktiviert... (Hey Jarvis)")
# Main background loop listening for wake word
while True:
time.sleep(0.5)
def main():
parser = argparse.ArgumentParser(description="Jarvis Desktop Voice Companion")
parser.add_argument("--trigger-now", action="store_true", help="Sofortige Spracheingabe starten")
args = parser.parse_args()
companion = JarvisCompanion()
if args.trigger_now:
companion.trigger_voice_session()
else:
companion.run_wake_word_loop()
if __name__ == "__main__":
main()
+28
View File
@@ -0,0 +1,28 @@
{
"gateway": {
"url": "ws://10.0.1.10:18789",
"token": "YOUR_OPENCLAW_GATEWAY_TOKEN",
"agent_id": "jarvis"
},
"wake_word": {
"engine": "openwakeword",
"model": "hey_jarvis",
"threshold": 0.5,
"audio_sample_rate": 16000
},
"tts": {
"engine": "edge-tts",
"voice": "de-DE-KillianNeural",
"rate": "+0%",
"pitch": "+0Hz"
},
"stt": {
"engine": "openclaw_realtime",
"language": "de"
},
"ui": {
"notifications": true,
"tray_icon": true,
"overlay_theme": "dark"
}
}
+28
View File
@@ -0,0 +1,28 @@
{
"gateway": {
"url": "ws://10.0.1.10:18789",
"token": "YOUR_OPENCLAW_GATEWAY_TOKEN",
"agent_id": "jarvis"
},
"wake_word": {
"engine": "openwakeword",
"model": "hey_jarvis",
"threshold": 0.5,
"audio_sample_rate": 16000
},
"tts": {
"engine": "edge-tts",
"voice": "de-DE-KillianNeural",
"rate": "+0%",
"pitch": "+0Hz"
},
"stt": {
"engine": "openclaw_realtime",
"language": "de"
},
"ui": {
"notifications": true,
"tray_icon": true,
"overlay_theme": "dark"
}
}
+10
View File
@@ -0,0 +1,10 @@
# Jarvis Desktop Voice Companion Integration for Hyprland
# Place in ~/.config/hypr/hyprland.conf or source it: source = ~/.config/jarvis-voice-companion/hyprland.conf
# Manual Voice Trigger Keybinding (Super + V)
bind = $mainMod, V, exec, python3 ~/.config/jarvis-voice-companion/companion.py --trigger-now
# Floating notification overlay rule
windowrulev2 = float, title:^(Jarvis Voice Companion)$
windowrulev2 = pin, title:^(Jarvis Voice Companion)$
windowrulev2 = move 100%-350 50, title:^(Jarvis Voice Companion)$
+31
View File
@@ -0,0 +1,31 @@
#!/usr/bin/env bash
set -e
echo "😏 Installing Jarvis Desktop Voice Companion..."
# Check Python3
if ! command -v python3 &> /dev/null; then
echo "❌ Python3 nicht gefunden. Bitte installiere python3."
exit 1
fi
# Install dependencies
echo "📦 Installiere Python Pakete..."
python3 -m pip install --upgrade pip
python3 -m pip install -r requirements.txt || true
# Install mpv / notify-send if missing on Arch / Ubuntu
if command -v pacman &> /dev/null; then
sudo pacman -S --needed --noconfirm mpv libnotify portaudio || true
elif command -v apt &> /dev/null; then
sudo apt update && sudo apt install -y mpv libnotify-bin portaudio19-dev || true
fi
# Ensure config directory exists
mkdir -p ~/.config/jarvis-voice-companion
if [ ! -f ~/.config/jarvis-voice-companion/config.json ]; then
cp config.json.template ~/.config/jarvis-voice-companion/config.json
fi
echo "✅ Installation erfolgreich abgeschlossen!"
echo "Starte mit: python3 companion.py"
+8
View File
@@ -0,0 +1,8 @@
openwakeword>=0.6.0
pyaudio>=0.2.14
numpy>=1.24.0
websocket-client>=1.7.0
edge-tts>=6.1.9
requests>=2.31.0
picovoice-porcupine>=3.0.0
gTTS>=2.5.0
+12
View File
@@ -0,0 +1,12 @@
[Unit]
Description=Jarvis Desktop Voice Companion Service
After=network.target sound.target
[Service]
Type=simple
ExecStart=/usr/bin/env python3 %h/.config/jarvis-voice-companion/companion.py
Restart=always
RestartSec=5
[Install]
WantedBy=default.target