ha-llmvision

环境要求

• 已安装并可正常运行的 Home Assistant
• 已安装 HACS（LLM Vision 在默认 HACS 仓库中，可直接搜索安装）
• Home Assistant Container 用户需要一个可挂载到容器 /media 的宿主机文件夹
• 一个可用的 AI 提供商账号或本地推理服务（如 OpenAI、Google Gemini、Ollama 等）

安装与启动步骤

1. 1在 HACS 中安装

   打开 HACS，搜索 LLM Vision 并安装。它已在默认 HACS 仓库中，无需手动添加自定义仓库。

2. 2重启 Home Assistant

   安装完成后必须重启 Home Assistant，集成才会被加载。在 设置 → 系统 中执行重启。

3. 3添加 LLM Vision 集成

   进入 设置 → 设备与服务，点击添加集成并搜索 LLM Vision。

4. 4提交默认设置

   选择 LLM Vision 后直接按提交（submit），先用默认设置完成初步配置。

5. 5准备 media 文件夹

   LLM Vision 使用更安全的 /media 目录存放快照。若用 Home Assistant Container，需在容器设置里把宿主机目录挂载到 /media，例如加上 -v /your/path:/media。

6. 6添加 AI 提供商

   回到 LLM Vision 集成页面，点击 Add Entry 添加你的第一个 AI Provider，按官方文档填写对应参数。

关键配置

如何确认成功

在 设置 → 设备与服务 中能看到 LLM Vision 集成，并且已成功添加至少一个 AI Provider 条目。

常见问题

注意事项

• LLM Vision 已收录在默认 HACS 仓库中，可直接在 HACS 内安装，无需手动添加仓库地址。
• 该集成可分析图片、视频文件、实时摄像头流以及 Frigate 事件，并可用 Timeline Card 在仪表盘上展示事件时间线。
• 详细的提供商配置说明见官方文档：https://llm-vision.gitbook.io/getting-started/setup/providers
• 官网：https://llmvision.org