home-generative-agent

AI agent for Home Assistant — 跟你的家對話、用白話文建立自動化規則、透過臉部辨識分析攝影機畫面,並主動接收異常警報。

home-generative-agent 是什麼?

AI 代理程式 for Home Assistant — 跟你的家對話、用白話文建立自動化規則、透過臉部辨識分析攝影機畫面,並主動接收異常警報。可選用雲端 LLM 或完全在地端執行。

home-generative-agent 概覽

這是什麼

Home Generative Agent (HGA) 是一個 Home Assistant 整合套件,將生成式 AI 代理帶入您的智慧家庭。它提供對所有 HA 實體的對話控制、具備人臉辨識的攝影機理解、長期語意記憶,以及 Sentinel 異常偵測引擎。它基於 LangGraph 建構,使用工具來控制實體、查詢歷史、監看攝影機,並撰寫真正的 HA 自動化。支援雲端 LLM(OpenAI、Gemini、Anthropic)或完全本機模型(透過 Ollama 或任何 OpenAI 相容伺服器)。

主要功能

  • 對話控制:以自然語言與您的家交談,開啟裝置、檢查狀態、提出問題。
  • 自動化建立:在聊天中描述您想要的內容,代理便會撰寫並註冊 HA 自動化;關鍵動作 PIN 碼可將解鎖門或開啟車庫的自動化保留,待 PIN 碼確認後才安裝。
  • 攝影機與影像分析:詢問代理在任何攝影機中看到的內容;主動式動作觸發分析與異常偵測;支援 Axis、Ring(透過 ring-mqtt)、Reolink、UniFi Protect,以及任何在 HA 中暴露動作實體或錄影狀態的攝影機。
  • Sentinel 異常偵測:確定性規則監控安全與保全問題(未上鎖的鎖、開啟的入口、不認識的人)並向您的手機發送警報;內建 Home Assistant 安全稽核,可標記管理員帳戶、存取權杖、暴露的連接埠等。
  • 人臉辨識:在攝影機畫面中識別人物並個人化警報(需選用的 face-service)。
  • 長期記憶:使用 pgvector 對過往對話進行語意搜尋;代理會記住您的偏好與情境。
  • 串流回應:第一個 token 會逐字出現在 HA 對話 UI 中。

使用情境

  • 以自然語言指令控制您的智慧家庭。
  • 無需撰寫 YAML 即可建立自動化。
  • 監控攝影機畫面,並接收主動式異常警報與人臉辨識通知。
  • 從 Sentinel 異常引擎接收主動式安全與保全警報。
  • 執行完全本機的 AI 代理,資料絕不離開您的家庭網路。

快速開始

請參閱儲存庫的 README 以取得完整安裝指南。快速入門需要 Home Assistant OS 或 Supervised,包括安裝 PostgreSQL with pgvector 應用程式,然後設定整合套件。

授權與價格

MIT 授權。開放原始碼。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/goruckhome-generative-agent.svg)](https://yunodb.com/tools/goruckhome-generative-agent?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/goruckhome-generative-agent?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/goruckhome-generative-agent.svg" alt="Featured on YunoDB" height="20"></a>