voice-agent-router

[](https://github.com/k5njm/voice-agent-router/actions/workflows/ci.yml) [](https://hacs.xyz) [](LICENSE)

A Home Assistant custom integration that provides an intelligent voice assistant with local fast-path routing for common commands (works offline) and cloud LLM fallback via OpenRouter for complex queries. Supports MCP server integration and a YAML-based skill system.

• Local intent routing -- regex-based matching handles lights, switches, locks, covers, climate, scenes, and state queries with zero latency and no cloud dependency.
• Cloud LLM fallback -- unmatched commands are forwarded to OpenRouter (OpenAI-compatible) with full Home Assistant tool-calling support.
• MCP server integration -- connect external Model Context Protocol servers to extend the assistant's tool set.
• YAML skill system -- define custom skills in simple YAML files with trigger patterns, response templates, and optional LLM backing.
• Entity cache with fuzzy matching -- spoken names are resolved to entity IDs using token-overlap scoring, so users do not need to memorize exact names.
• Configurable via UI -- set up API keys, model selection, system prompts, and feature toggles through the Home Assistant config flow.

Voice Input
    |
    v
+-----------------------+
| Conversation Entity   |
+-----------------------+
    |
    v
+-----------------------+     match     +------------------+
| Intent Router         | -----------> | Local Execution  |
| (regex fast-path)     |              | (HA service call)|
+-----------------------+              +------------------+
    | no match
    v
+-----------------------+     match     +------------------+
| Skill Loader          | -----------> | Skill Execut