ha-chat-card
is a powerful and highly customizable AI chat interface for Home Assistant, providing an intelligent, multilingual, and seamless conversational experience.
Latest Release: 2025.01.25
- Deep Thinking Mode: Advanced reasoning, multi-dimensional problem analysis, and transparent thought process visualization.
- Typing Effect: Simulates real-time AI thinking for a more natural interaction.
- Voice Recognition: Supports voice input via long-press send button on Android and iOS, optimized for Chrome.
- Wake Word Activation: Customizable wake words, low-latency recognition, microphone permission handling, and wake-up sound customization.
- Configurable interface and response languages.
- Supports Chinese (Simplified)
zh-cn
with extensibility for additional languages.
- Configurable multi-agent priority settings.
- Supports up to three parallel AI agents with intelligent switching and automatic fallback mechanisms.
- Multiple TTS engine modes: Off, browser playback, Home Assistant service call.
- Configurable voice devices and engine selection.
- Session Management: Conversation history storage, session ID persistence, and cookie storage.
- Performance Optimization: Low resource consumption, intelligent audio context unlocking, and an anti-conflict design.
type: custom:ha-chat-card
agent_id: conversation.home_assistant
agents:
- conversation.home_assistant
voice_recognition: true
wake_word: 'hey assistant'
language: 'en'
response_language: 'en'
deep_think: true
tts_mode: 'service'
tts_engine: 'tts.google_translate'
- Home Assistant (2023.x or later)
- Modern browser supporting ES modules (Chrome, Firefox, Edge)
- Microphone permissions (optional)
- Copy
ha-chat-card.js
to Home Assistant'swww
directory. - Add the following to
configuration.yaml
:
frontend:
extra_module_url:
- /local/ha-chat-card.js
- Use simple 2-4 word phrases.
- Avoid complex sentences.
- Supports custom wake-up sounds.
- Select an appropriate voice engine.
- Configure media playback devices.
- Supports personalized voice selection.
- Desktop Browsers: Chrome, Firefox, Edge.
- Mobile Devices: Android, iOS.
- Home Assistant: 2023.x and above.
We welcome contributions! Feel free to submit issues and pull requests to improve this project.
- Home Assistant
- Web Components
For issues and discussions, please submit an issue in the project repository.