goruck/home-generative-agent

해결하는 문제

Home Generative Agent (HGA)는 표준 Home Assistant 설정을 지능적이고 대화형 스마트 홈으로 변환합니다. 경직되고 수동적인 자동화 문제를 해결하여 사용자가 자연어로 기기를 제어하고, 자동화를 만들고, 홈 기록을 조회할 수 있게 하면서 사전 예방적 보안 모니터링을 제공합니다.

작동 방식

HGA는 Home Assistant에 직접 통합되는 LangGraph 기반 에이전트입니다. 스마트 홈 엔터티와 상호 작용하는 도구 조합, 장기 의미 메모리를 위한 pgvector가 포함된 PostgreSQL 데이터베이스, 결정적 보안 및 이상 탐지를 위한 "Sentinel" 엔진을 사용합니다. 클라우드 기반 LLM(OpenAI, Gemini, Anthropic)과 로컬 모델(Ollama 또는 OpenAI 호환 서버를 통해)을 모두 지원하므로 사용자가 데이터를 완전히 로컬로 유지할지 클라우드 처리를 사용할지 선택할 수 있습니다.

대상 사용자

이 프로젝트는 홈 자동화를 위한 정교한 AI 기반 인터페이스를 원하는 Home Assistant 사용자를 위한 것입니다. 셀프 호스팅(또는 로컬 LLM 인프라 사용)에 익숙하고 단순한 음성 명령을 넘어 홈 상태를 "추론"하고 즉석에서 자동화를 작성하며 보안 감사를 수행할 수 있는 시스템을 원하는 사용자에게 이상적입니다.

주요 기능

• 대화형 제어: 홈에 말을 걸어 기기를 관리하고 상태를 확인하거나 질문합니다.
• 자동화 로직: 자동화를 일반 영어로 설명하면 에이전트가 YAML 코드를 작성, 등록 및 관리합니다.
• 사전 예방적 보안: "Sentinel" 엔진이 네트워크와 홈 기기의 자동 보안 감사를 수행하여 노출된 포트나 무단 액세스와 같은 취약점을 표시합니다.
• 멀티모달 기능: 카메라 영상을 분석하여 객체 또는 얼굴 인식을 수행하고 사전 예방적 알림을 받습니다.
• 프라이버시 우선 옵션: 로컬 LLM, 음성 인식, 음성 합성 엔진과 완전히 호환되어 데이터를 홈 네트워크 내에 유지합니다.