Skip to content

'ha-chat-card' is Home Assistant's AI chat component that supports speech recognition, wake words, multi-language interaction, and TTS speech synthesis to provide an intelligent home conversation experience. It optimizes AI agent management to ensure efficient, smooth, and intelligent interactions.

License

Notifications You must be signed in to change notification settings

knoop7/ha-chat-card

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🤖 Home Assistant Chat Card Web Component

中文版本

🌟 Overview

ha-chat-card is a powerful and highly customizable AI chat interface for Home Assistant, providing an intelligent, multilingual, and seamless conversational experience.

🚀 Version

Latest Release: 2025.01.25

✨ Features

🔹 Intelligent AI Engine

  • 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 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.

🌍 Multilingual Support

  • Configurable interface and response languages.
  • Supports Chinese (Simplified) zh-cn with extensibility for additional languages.

🤖 AI Agent Management

  • Configurable multi-agent priority settings.
  • Supports up to three parallel AI agents with intelligent switching and automatic fallback mechanisms.

🔊 Text-to-Speech (TTS)

  • Multiple TTS engine modes: Off, browser playback, Home Assistant service call.
  • Configurable voice devices and engine selection.

🔧 Configuration & Security

  • 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.

📌 Configuration Example

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'

📦 Installation Guide

Prerequisites

  • Home Assistant (2023.x or later)
  • Modern browser supporting ES modules (Chrome, Firefox, Edge)
  • Microphone permissions (optional)

Installation Steps

  1. Copy ha-chat-card.js to Home Assistant's www directory.
  2. Add the following to configuration.yaml:
frontend:
  extra_module_url:
    - /local/ha-chat-card.js

⚙️ Advanced Configuration

Wake Word Settings

  • Use simple 2-4 word phrases.
  • Avoid complex sentences.
  • Supports custom wake-up sounds.

TTS Service Configuration

  • Select an appropriate voice engine.
  • Configure media playback devices.
  • Supports personalized voice selection.

🌐 Compatibility

  • Desktop Browsers: Chrome, Firefox, Edge.
  • Mobile Devices: Android, iOS.
  • Home Assistant: 2023.x and above.

🤝 Contributing

We welcome contributions! Feel free to submit issues and pull requests to improve this project.

🔗 Related Projects

  • Home Assistant
  • Web Components

📞 Support

For issues and discussions, please submit an issue in the project repository.

About

'ha-chat-card' is Home Assistant's AI chat component that supports speech recognition, wake words, multi-language interaction, and TTS speech synthesis to provide an intelligent home conversation experience. It optimizes AI agent management to ensure efficient, smooth, and intelligent interactions.

Resources

License

Stars

Watchers

Forks

Packages

No packages published