voice-satellite-card-integration  by jxlarrea

Browser-based voice AI for Home Assistant

Created 2 months ago
289 stars

Top 91.0% on SourcePulse

GitHubView on GitHub
Project Summary

Voice Satellite transforms any web browser into a private, hands-free voice assistant for Home Assistant, offering an alternative to commercial assistants like Alexa or Google Home. It enables voice control, queries, and device management directly from your own hardware, prioritizing user privacy and local processing.

How It Works

This integration operates as a global JavaScript engine within the user's browser, registering as a native assist_satellite device in Home Assistant. It features on-device wake word detection using microWakeWord running locally in pure JavaScript, with an option to fall back to server-side processing. The system handles wake word detection, command transcription, media playback, and visual feedback, integrating seamlessly with Home Assistant's Assist pipeline.

Quick Start & Requirements

  • Installation: Install via HACS or manually copy custom_components/voice_satellite to HA config.
  • Prerequisites: Requires HA 2025.2.1+, configured Assist Pipeline (STT, Conv, TTS), and browser with mic/HTTPS access. Screen must stay active (use screensaver).
  • Setup: Add integration, name per device, configure via sidebar panel.
  • Docs: https://github.com/jxlarrea/voice-satellite-card-integration

Highlighted Details

  • On-Device Wake Word: Pure JS microWakeWord for low-latency, private detection. Supports custom models, stop-word interruption, noise gating.
  • LLM Tools (Experimental): Experimental LLM Tools integration provides visual results for image, video, web, Wikipedia, weather, and financial queries.
  • Customizable UI: 7 built-in skins (e.g., Alexa, Google Home, HA, Siri) with extensive CSS customization.
  • Media Player Integration: Exposes media_player entity for volume control, TTS routing, and media playback.
  • Voice Interaction Events: Fires voice_satellite_chat events with detailed payloads for automations.
  • Mini Card: Optional voice-satellite-mini-card for in-dashboard transcript display.

Maintenance & Community

No specific details regarding maintainers, community forums (like Discord/Slack), or roadmap were found in the provided README.

Licensing & Compatibility

  • License: MIT License.
  • Compatibility: Designed for modern web browsers. Requires HTTPS for microphone access. Some advanced features like voice isolation are Chrome-specific.

Limitations & Caveats

Browser environments necessitate HTTPS and continuous screen activity for microphone functionality. The built-in Home Assistant conversation agent does not support multi-turn dialogues. The Home Assistant Companion App may require explicit configuration for TTS audio playback. LLM tools are experimental and depend on an additional integration.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
20
Star History
123 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.