Home Assistant GPT4Vision 开源项目使用教程

Home Assistant GPT4Vision 开源项目使用教程

ha-gpt4vision Image Analyzer for Home Assistant using GPT Vision 项目地址: https://gitcode.com/gh_mirrors/ha/ha-gpt4vision

1. 项目目录结构及介绍

Home Assistant GPT4Vision 的目录结构如下：

ha-gpt4vision/
├── .github/
│   └── ...
├── benchmark_visualization/
│   └── ...
├── blueprints/
│   └── ...
├── custom_components/
│   └── llmvision/
│       ├── __init__.py
│       ├── ai_provider.py
│       ├── camera.py
│       ├── const.py
│       ├── helpers.py
│       └── timeline.py
├── .gitignore
├── LICENSE
├── NOTICE
├── README.md
├── hacs.json
└── ...

• .github/: 存放与 GitHub 相关的配置文件。
• benchmark_visualization/: 存放性能测试和可视化相关的文件。
• blueprints/: 存放项目蓝图文件，用于定义项目的配置和流程。
• custom_components/llmvision/: 核心组件目录，包含以下文件：
  • __init__.py: 初始化组件。
  • ai_provider.py: 定义 AI 提供者的接口和实现。
  • camera.py: 处理摄像头相关的功能。
  • const.py: 定义常量。
  • helpers.py: 辅助函数。
  • timeline.py: 时间线功能实现。
• .gitignore: 定义 Git 忽略的文件和目录。
• LICENSE: 项目许可证文件。
• NOTICE: 通知文件，可能包含项目相关的法律声明。
• README.md: 项目说明文件。
• hacs.json: Home Assistant Community Store (HACS) 配置文件。

2. 项目的启动文件介绍

项目的启动主要依赖于 Home Assistant 的自定义组件机制。在 custom_components/llmvision/__init__.py 文件中，会进行组件的初始化工作。

def setup(hass, config):
    # 初始化代码
    ...
    return True

这段代码会在 Home Assistant 启动时调用，用于设置和初始化 GPT4Vision 组件。

3. 项目的配置文件介绍

项目的配置主要通过 Home Assistant 的配置文件进行，通常位于 ~/.homeassistant/configuration.yaml。以下是一个配置示例：

llmvision:
  ai_provider: openai
  cameras:
    - entity_id: camera.front_door
    - entity_id: camera.back_yard
  timeline:
    enabled: true
    entity_id: timeline.llmvision

• ai_provider: 指定 AI 提供商，例如 openai。
• cameras: 列出需要分析的摄像头实体 ID。
• timeline: 时间线功能的配置，可以开启或关闭，并指定实体 ID。

ha-gpt4vision Image Analyzer for Home Assistant using GPT Vision 项目地址: https://gitcode.com/gh_mirrors/ha/ha-gpt4vision