ai-conversation

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #llm #golang #machine-learning #deep-learning #java #kubernetes #pytorch #ios #openai #open-source

ai-conversation

(★ 18)

🤖 AI Conversation Agent for Home Assistant. Compatible with any OpenAI format LLM providers, supports STT/TTS

ai-conversation Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🤖 AI Conversation Agent

## Install

#### Method 1: [HACS](https://my.home-assistant.io/redirect/hacs_repository/?category=integration&owner=hasscc&repository=ai-conversation)

#### Method 2: Manually installation via Samba / SFTP
> Download and copy `custom_components/ai_conversation` folder to `custom_components` folder in your HomeAssistant config folder

#### Method 3: Onekey shell via SSH / Terminal & SSH add-on
```shell
wget -O - https://get.hacs.vip | DOMAIN=ai_conversation REPO_PATH=hasscc/ai-conversation ARCHIVE_TAG=main bash -
```

#### Method 4: shell_command service
1. Copy this code to file `configuration.yaml`
    ```yaml
    shell_command:
      update_ai_conversation: |-
        wget -O - https://get.hacs.vip | DOMAIN=ai_conversation REPO_PATH=hasscc/ai-conversation ARCHIVE_TAG=main bash -
    ```
2. Restart HA core
3. Call this [`action: shell_command.update_ai_conversation`](https://my.home-assistant.io/redirect/developer_call_service/?service=shell_command.update_xiaomi_miot) in Developer Tools
2. Restart HA core again

## Config

[![Config AI Conversation](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=ai_conversation)

1. Add Service / 添加服务(模型提供商)
2. Add AI Model / 添加对话/STT/TTS模型

## Actions

### Explain media
```yaml
action: ai_conversation.explain_media
data:
  entity_id: conversation.agent_glm_4_7v_flash
  prompt: Explain this video
  video: https://ha.your.domain/media/local/camera.mp4
  tags:
    - Car
    - Delivery Person

# Response
message: The video captures a street scene where multiple cars pass by on the road.
tags:
   - Car
tags_string: "#Car"
usage:
   completion_tokens: 180
   prompt_tokens: 3683
   total_tokens: 3863
```

## MCP Server

This component provides an MCP server to pass the user's smart home needs to the Home Assistant's conversation agent.

You may create a Long-lived access token to allow the client to access the API.
1. Visit your account profile settings, under the Security tab. [![Home Assistant user's security options.](https://my.home-assistant.io/badges/profile_security.svg)](https://my.home-assistant.io/redirect/profile_security/)
2. Create a Long-lived access token.
3. Copy the access token to use when configuring the MCP client LLM application.

```yaml
{
  "mcpServers": {
    "ha_conversation": {
      "name": "Home Assistant",
      "type": "sse",
      "baseUrl": "http://homeassistant.local:8123/ai_conversation/sse",
      "headers": {
        "Authorization": "Bearer YourLong-livedAccessToken"
      }
    }
  }
}
```
If you want to specify a conversation agent, you can add the query parameter `agent_id`.
```yaml
"baseUrl": "http://homeassistant.local:8123/ai_conversation/sse?agent_id=conversation.agent_glm_4_7v_flash",
```

## Links

- [智谱AI免费不限量模型](https://www.bigmodel.cn/invite?icode=EwilDKx13%2FhyODIyL%2BKabHHEaazDlIZGj9HxftzTbt4%3D)
- [免费STT模型: Qwen ASR](https://github.com/aahl/qwen-asr2api) / [加载项](https://gitee.com/hasscc/addons/tree/main/qwen-asr)
- [免费TTS模型: Z.ai TTS](https://github.com/aahl/zai-tts2api) / [加载项](https://gitee.com/hasscc/addons/tree/main/zai-tts)
- [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)
- [New API](https://github.com/QuantumNous/new-api)

ai-conversation

ai-conversation Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ai-conversation

ai-conversation Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README