ha-claude

<h3 align="center">Generated by AI for AI</h3>
<p align="center">
  <img src="image/amira-logo.png" width="38%">
</p>

<table align="center">
  <tr>
    <td align="center" width="260">
      <a href="https://ko-fi.com/silviosmart">
        <img src="https://storage.ko-fi.com/cdn/generated/zfskfgqnf/2025-03-07_rest-7d81acd901abf101cbdf54443c38f6f0-dlmmonph.jpg" width="220">
      </a>
    </td>
    <td align="left">
      <h2>☕ Support My Work</h2>
      <p>
        🇮🇹 Se ti piace il mio lavoro e vuoi che continui nello sviluppo delle card,
        puoi offrirmi un caffè.
      </p>
      <p>
        🇬🇧 If you like my work and want me to continue developing the cards,
        you can buy me a coffee.
      </p>
    </td>
  </tr>
</table>

<br>

<p align="center">
  <a href="https://www.paypal.com/donate/?hosted_button_id=Z6KY9V6BBZ4BN">
    <img src="https://img.shields.io/badge/Donate-PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white">
  </a>
</p>

### 🌍 Follow Me

<p align="center">
  <a href="https://www.tiktok.com/@silviosmartalexa">
    <img src="https://img.shields.io/badge/Follow-TikTok-000000?style=for-the-badge&logo=tiktok&logoColor=white">
  </a>
  &nbsp;
  <a href="https://www.instagram.com/silviosmartalexa">
    <img src="https://img.shields.io/badge/Follow-Instagram-E1306C?style=for-the-badge&logo=instagram&logoColor=white">
  </a>
  &nbsp;
  <a href="https://www.youtube.com/@silviosmartalexa">
    <img src="https://img.shields.io/badge/Subscribe-YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white">
  </a>
</p>

---

### 🏠🤖 Amira Ai Assistant

**Smart home AI assistant addon** with multi-provider support — control your home, create automations, and manage configurations using natural language.

Supports **23+ AI providers** and **60+ models**: Anthropic Claude, OpenAI, Google Gemini, NVIDIA NIM, GitHub Models, GitHub Copilot (OAuth), OpenAI Codex (OAuth), Claude Web, Gemini Web, Groq, Mistral, DeepSeek, Ollama and more. Chat via **Telegram**, **WhatsApp**, or **Discord** in addition to the built-in web UI.

[![GitHub Release](https://img.shields.io/github/v/release/Bobsilvio/ha-claude)](https://github.com/Bobsilvio/ha-claude/releases)
[![License: PolyForm NC](https://img.shields.io/badge/License-PolyForm%20NC%201.0-blue)](LICENSE)
[![Home Assistant](https://img.shields.io/badge/Home%20Assistant-2024.1%2B-blue)](https://www.home-assistant.io/)

---

## Video Guide Ita

[![Watch the demo](https://img.youtube.com/vi/Vh7OqmvVLWY/hqdefault.jpg)](https://youtu.be/Vh7OqmvVLWY)
Click the image to watch the video on YouTube.

## ✨ Key Features

### 🎯 Smart Home Control
- **Natural Language**: Control devices using conversational commands
- **Device Query**: Ask about states, history, and statistics
- **Service Calls**: Execute any Home Assistant service
- **Areas & Rooms**: Manage spaces and assign entities

### 🤖 Automation Management
- **Create Automations**: Build complex automations with triggers, conditions, and actions
- **Modify Existing**: Update automations with natural language instructions
- **YAML Diff View**: See exactly what changed with before/after comparison
- **Smart Suggestions**: AI understands your devices and suggests improvements

### 🔧 System Diagnostics & Repairs
- **Read Repairs**: View active HA repair issues and warnings
- **Health Check**: System health diagnostics (unsupported/unhealthy components)
- **AI Suggestions**: AI analyzes issues and suggests concrete fixes
- **Dismiss Issues**: Acknowledge and dismiss resolved repairs

### � File Upload
- **Multi-Format**: Upload PDF, DOCX, TXT, MD, YAML for AI analysis
- **Drag & Drop**: Drop files directly into chat (ON by default)
- **Context Injection**: Uploaded content is included in the AI conversation

### 👁️ Vision Support
- **Image Upload**: Send screenshots, photos, or dashboard images
- **Visual Analysis**: AI can see and understand images
- **Card Recreation**: "Create cards like this image" — AI analyzes and recreates layouts
- **Multi-Provider**: Works with Claude, GPT-4o, Gemini vision models

### 🔍 RAG (Retrieval-Augmented Generation)
- **Semantic Search**: Search over uploaded documents with vector embeddings
- **Automatic Indexing**: Documents are indexed on upload
- **Enable in Settings**: Settings → Features → RAG (OFF by default)

### 📝 Configuration File Access
- **Read/Write YAML**: Access automations, scripts, scenes, and custom configs
- **File Explorer**: Browse your Home Assistant config directory
- **Safe Editing**: Automatic snapshots before modifications
- **Config Validation**: Check configuration before applying changes

### 🧠 Memory
- **Persistent Knowledge**: `MEMORY.md` injected in every conversation — the AI always remembers
- **Session Log**: `HISTORY.md` append-only log of past sessions
- **Enable in Settings**: Settings → Features → Memory (OFF by default)
- **Storage**: `/config/amira/memory/`

### 💬 Interactive Chat Interface
- **Chat History**: Keep last N conversations, switch between them
- **Streaming Responses**: Real-time token-by-token output
- **Tool Indicators**: See what the AI is doing (badges for each tool call)
- **Copy Button**: One-click copy for all code blocks (YAML, JSON, Python)

### 🫧 Floating Chat Bubble
- **Always Available**: AI chat bubble on every Home Assistant page (ON by default)
- **Amira Card Editor Button**: 🤖 Amira button in the Lovelace card editor for inline AI help
- **Independent Toggles**: Bubble and card button can be enabled/disabled separately
- **Context-Aware**: Detects automations, scripts, and HTML dashboards
- **HTML Dashboard Editing**: Modify dashboards in-place keeping same style
- **Voice Input**: Built-in voice recognition with multi-provider TTS
- **Agent Switching**: Change AI provider/model on the fly
- **Tool Feedback**: Thinking indicator + step badges during multi-tool execution

### 🔄 Provider Fallback
- **Automatic Chain**: If primary provider fails, Amira tries the next one
- **Configurable Order**: Set your preferred fallback sequence
- **Enable in Settings**: Settings → Features → Auto Fallback (OFF by default)

### 🤖 Multi-Agent System
- **Custom Agents**: Create agents with their own model, provider, tools, and custom instructions
- **Agent Switching**: Select agents from the chat UI dropdown
- **Channel Routing**: Assign different agents to Telegram/WhatsApp channels
- **Instructions field**: Add personality/context prepended to the HA default prompt — the agent keeps full HA awareness

### 💰 Cost Tracking
- **Per-Message Cost**: Tracks token usage and cost for every message
- **Cache Breakdown**: Shows prompt caching savings
- **Daily Aggregates**: Usage statistics over time
- **Multi-Currency**: USD or EUR

### 🧩 Skills
- **Skill Store**: Install expert AI skills directly from the Settings panel → 🧩 Skills tab
- **Slash command**: type `/skill-name your request` in chat to activate a skill — the AI receives expert documentation and responds accordingly
- **Autocomplete**: typing `/` in the chat input shows installed skills with name and description
- **Update notifications**: a banner appears at the top of the chat when an installed skill has an update available in the store
- **Built-in skills**: `swiss-army-knife-card`, `html-js-card`, `mushroom` — more coming

### 🌍 Multilingual Support
- **4 Languages**: English, Italian, Spanish, French
- **AI Responses**: AI always responds in your chosen language
- **Config UI Translations**: Settings labels and descriptions in all 4 languages

### 🔌 MCP (Model Context Protocol)
- **Custom Tools**: Connect external services via MCP servers
- **Filesystem, Web Search, Git, Databases**: and any custom MCP-compatible server
- **Multi-server**: Run multiple MCP servers simultaneously
- **Start/Stop from UI**: Each server shows a live status badge — start and stop directly from Settings → MCP
- **Auto-restart**: Servers you start manually are remembered and restarted on add-on reboot


[truncated…]