The multi-provider voice assistant for Home Assistant — 15+ built-in functions, 6 LLM providers, local-first, and completely free.
🎯 Like Alexa, but you choose the brain. Local or cloud. Your call.
"Poly" = Many. Many voices. Many providers. Many functions. One seamless assistant.
| Feature | Alexa/Google | PolyVoice |
|---|---|---|
| Voice Control | ✅ | ✅ |
| Smart Home | ✅ | ✅ + Native HA |
| Weather | ✅ | ✅ OpenWeatherMap |
| Music Control | ✅ | ✅ Music Assistant |
| Calendar | ✅ | ✅ Any HA Calendar |
| Sports Scores | ✅ | ✅ Live Scores |
| Choose Your AI | ❌ Locked in | ✅ 6 Providers |
| AI Camera Vision | ❌ | ✅ "Who's at the door?" |
| 100% Local Option | ❌ | ✅ Your Hardware |
| Privacy | ❌ Cloud | ✅ Local First |
| Monthly Cost | $0-10+ | $0 |
| Provider | Type | Cost | Best For |
|---|---|---|---|
| LM Studio | Local | FREE | Privacy, Offline |
| OpenRouter | Cloud | FREE tier | Best Models |
| Groq | Cloud | FREE | ⚡ Fastest |
| OpenAI | Cloud | Paid | GPT-4 Quality |
| Anthropic | Cloud | Paid | Claude Quality |
| Cloud | FREE tier | Gemini |
Switch providers anytime. Your config stays the same.
- Open HACS → Integrations → ⋮ → Custom Repositories
- Add:
https://github.com/LosCV29/polyvoice - Install "PolyVoice"
- Restart Home Assistant
- Settings → Devices & Services → Add Integration → "PolyVoice"
cp -r polyvoice /config/custom_components/Toggle each on/off in the UI. Only enable what you need!
| Function | Description | Requires |
|---|---|---|
| 🌤️ Weather | Current + 5-day forecast | OpenWeatherMap API |
| 📅 Calendar | View upcoming events | HA Calendar entities |
| 🎵 Music | Play, pause, skip, transfer | Music Assistant |
| 📹 Cameras | AI video analysis | ha_video_vision |
| 🏈 Sports | Live scores & schedules | — |
| 📰 News | Headlines by category | NewsAPI |
| 📍 Places | Find nearby locations | Google Places API |
| 🍕 Restaurants | Ratings & recommendations | Yelp API |
| 🌡️ Thermostat | Temperature control | Climate entity |
| 🚪 Devices | Doors, locks, sensors | Device aliases |
| 📚 Wikipedia | Knowledge lookup | — |
| 🎂 Age | Celebrity ages | — |
| ⏰ Time | Current date/time | — |
"What's the weather?"
"Play jazz in the living room"
"Is the front door locked?"
"Set the AC to 72"
"Did the Lakers win?"
"Who's at the driveway?"
"Find the nearest gas station"
"What's on my calendar tomorrow?"
"How old is Tom Hanks?"
After setup, configure via: Settings → Devices & Services → PolyVoice → Configure
| Section | Configure |
|---|---|
| Connection | Provider, API key, URL |
| Model | Temperature, tokens, model |
| Features | Toggle functions on/off |
| Entities | Thermostat, calendars, players |
| API Keys | Weather, Places, Yelp, News |
| Location | Override HA location |
| Intents | Native HA handling |
| Advanced | System prompt |
Calendars (one per line):
calendar.personal
calendar.work
Music Players (room:entity_id):
living room:media_player.living_room
kitchen:media_player.kitchen
everywhere:media_player.whole_home
Device Aliases (alias:entity_id):
front door:lock.front_door
garage:cover.garage_door
| Feature | Provider | Free Key |
|---|---|---|
| Weather | OpenWeatherMap | openweathermap.org |
| Places | console.cloud.google.com | |
| Restaurants | Yelp | yelp.com/developers |
| News | TheNewsAPI | thenewsapi.com |
For AI camera vision, install the companion:
- Real video analysis (not snapshots!)
- Works with any RTSP camera
┌─────────────────────────────────────────┐
│ YOUR SETUP │
├─────────────────────────────────────────┤
│ Primary: LM Studio (local) │
│ └── Qwen 7B or Llama 3.2 │
│ │
│ Backup: OpenRouter (free) │
│ └── Llama 3.3 70B │
│ │
│ Cameras: HA Video Vision │
│ └── Nemotron (free) │
└─────────────────────────────────────────┘
Total Monthly Cost: $0
No tools available?
- Enable features in options
- Add required API keys
- Configure entities
Can't connect?
- LM Studio: Check server URL
- Cloud: Verify API key
Slow responses?
- Try smaller model (7B)
- Use Groq (fastest cloud)
- HA Video Vision — AI cameras
- Music Assistant — Multi-room audio
- ESPHome Voice — Local wake word
- Wyoming — Voice pipelines
| Version | Changes |
|---|---|
| 1.0.0 | Initial release — 6 providers, 15+ functions |
MIT License — See LICENSE
Built with ❤️ for the Home Assistant community.
⭐ Star this repo if PolyVoice helps you!