Home Generative Agent란?
Home Generative Agent는 사용자의 말을 언어 모델에 전달하는 데 그치지 않고 집에 직접 작용하는 Home Assistant용 AI 에이전트입니다. README에 따르면 LangGraph를 기반으로 하며, 도구를 사용해 엔티티를 제어하고, 기록을 조회하고, 카메라를 확인하고, 실제 자동화를 작성합니다.
HACS로 설치하는 Home Assistant 커스텀 통합이며 독립 실행형 앱이 아닙니다. Sentinel 엔진은 고정 규칙으로 보안 문제를 감시하며, README는 그 부분에서 언어 모델이 조언만 할 뿐 아무것도 작동시키지 않는다고 밝히지만, 이는 개발자의 설명이며 확인하지 않았습니다. 커뮤니티 스레드의 첫 글은 GitHub보다 오래된 버전을 표시하고 있어, 이 리뷰는 GitHub를 따랐습니다.
구하는 방법
Home Generative Agent는 기존 Home Assistant에 HACS로 설치하며, 독립 실행형 다운로드는 없습니다.
방법 | 구하는 방법 |
|---|---|
| HACS(권장) | 기본 저장소에 등록된 HACS에서 검색하거나 README의 「Open in HACS」 버튼을 사용합니다. 그다음 Home Assistant를 재시작하고 통합을 추가합니다 |
| 수동 설치 | GitHub Releases에서 home_generative_agent.zip을 받아 설치 가이드대로 Home Assistant에 복사합니다 |
| 데이터베이스 | Home Assistant OS 또는 Supervised의 PostgreSQL with pgvector 앱, 또는 직접 운영하는 PostgreSQL 서버 |
| 웹사이트 | Home Assistant 커뮤니티 스레드, GitHub에 기재된 프로젝트 홈페이지 |
| 문서 | 저장소의 가이드: 설치, 설정, Sentinel, 카메라, 아키텍처 |
| 개인정보 처리방침 | 저장소와 커뮤니티 스레드에서 찾지 못했습니다 |
| 소스 코드 | github.com/goruck/home-generative-agent, MIT 라이선스 |
검토한 버전: 3.44.10, GitHub Releases에 따르면 2026년 10월 23일 공개. 사전 릴리스인 3.45.0-beta.5도 있으나 검토하지 않았습니다. Home Assistant 쪽 단계는 웹 인터페이스에서 진행하지만 Ollama 모델을 받을 때는 터미널을 쓰며, 서비스 전체를 연결하는 데는 단일 설치보다 많은 노력이 듭니다.
요구 사항
Home Assistant 2026.8.0 이상, HACS, pgvector가 있는 PostgreSQL 데이터베이스, 그리고 하나 이상의 모델 제공자가 필요합니다.
Home Assistant
- 자료의 설명:
- 최소 2026.8.0(HGA 3.43.3부터)이며, 2026.9와 2026.10도 지원으로 명시되어 있습니다
데이터베이스
- 자료의 설명:
- pgvector가 있는 PostgreSQL. 없으면 메모리 내 저장만 되어 장기 기억, 얼굴 인식, 기준선 이상 탐지를 쓸 수 없습니다
모델 제공자
- 자료의 설명:
- OpenAI, Gemini, Anthropic, Ollama 또는 모든 OpenAI 호환 서버
로컬 모델(선택)
- 자료의 설명:
- 가이드는 gpt-oss, qwen3:8b, qwen3-vl:8b 같은 Ollama 모델을 나열하지만 최소 RAM이나 VRAM은 제시하지 않습니다
얼굴 인식(선택)
- 자료의 설명:
- 별도로 구축하는 외부 얼굴 서비스
음성(선택)
- 자료의 설명:
- OpenAI 음성 API 또는 Speaches 같은 OpenAI 호환 로컬 서버. 대형 faster-whisper 모델에는 VRAM 약 2 GB가 권장됩니다
어떤 하드웨어가 어떤 모델에 맞는지는 이 이상 밝혀져 있지 않습니다. 그것은 Home Generative Agent가 아니라 모델 서버에 달려 있습니다.
시작하는 방법
단계는 README와 설치 가이드를 따릅니다. PromptQuorum이 직접 실행해 보지는 않았습니다.
- 1데이터베이스 준비
Why it matters: Home Assistant OS 또는 Supervised에 PostgreSQL with pgvector 앱을 설치하거나, 통합이 직접 운영하는 PostgreSQL 서버를 가리키게 합니다. - 2HACS로 설치하고 재시작
Why it matters: HACS에서 Home Generative Agent를 설치하고 Home Assistant를 재시작한 뒤, 설정 → 기기 및 서비스에서 통합을 추가합니다. - 3모델 제공자 추가
Why it matters: + Model Provider를 누르고 Edge(Ollama 또는 OpenAI 호환 서버) 또는 Cloud(OpenAI, Gemini, Anthropic)를 선택합니다. - 4Setup 실행
Why it matters: + Setup을 누르고 권장 기본값으로 모든 기능을 켜는 Basic 또는 기능별로 설정하는 Advanced를 선택합니다. - 5대화 에이전트로 선택
Why it matters: 설정 → 음성 어시스턴트에서 Home Generative Agent를 선택한 뒤, 보여 주려는 엔티티를 공개합니다.
자료로 확인된 기능
아래 항목은 모두 README나 문서에서 가져온 것이며, 여기서 직접 테스트한 것은 없습니다.
- 대화. 공개된 엔티티에 대한 자연어 제어와 상태 질문이 가능하며, 응답은 스트리밍으로 표시됩니다.
- 자동화. 채팅으로 자동화를 작성하고 등록합니다. 엔티티 ID와 서비스 호출은 먼저 Home Assistant에서 검증되며, 선택 사항인 Critical Action PIN을 켜면 문을 열거나 차고 문을 여는 자동화는 보류됩니다.
- 카메라. 카메라 이미지를 설명하고 움직임 감지로 시작되는 분석을 수행합니다. README에는 Axis, ring-mqtt를 통한 Ring, Reolink, UniFi Protect와 움직임 엔티티를 제공하는 모든 카메라가 언급됩니다.
- Sentinel. 규칙 기반 이상 탐지와 Home Assistant 환경의 보안 감사를 제공하며, 휴대폰 알림과 선택적 언어 모델 분류가 있습니다.
- 기억과 도구. pgvector의 장기 의미 기억, 그리고 MCP 서버나 Home Assistant LLM API를 통한 웹 검색 같은 추가 도구.
- 음성. Assist 파이프라인용 자체 음성 인식·음성 합성 제공자로, OpenAI 또는 로컬 서버를 사용합니다.
데이터 흐름과 개인정보
데이터가 어디로 가는지는 선택한 모델 제공자에 달려 있습니다. README에 따르면 Home Generative Agent는 Ollama나 OpenAI 호환 서버로 완전히 로컬에서 실행할 수 있고, 클라우드 제공자는 대안입니다.
클라우드 제공자를 쓰면 프롬프트와 분석을 요청한 카메라 이미지가 해당 제공자의 정책에 따라 그쪽으로 전달됩니다. README는 Sentinel과 감사 도구가 언어 모델에 무엇인가를 보여 주기 전에 MAC 주소, IP 주소, 클라이언트 호스트 이름을 가린다고 덧붙입니다. 얼굴 인식은 별도의 얼굴 서비스를 사용하며, 그 저장 방식은 이 리뷰에서 살펴보지 않았습니다.
📌참고: 이는 개발자의 설명이며 감사 결과가 아닙니다. PromptQuorum은 코드나 네트워크 트래픽을 검사하지 않았습니다.
이런 분께 적합합니다
- 여유 GPU 머신이 있는 Home Assistant 사용자. Ollama로 자기 네트워크 안에 머무는 대화 에이전트를 원하는 분.
- 일상 언어 요청으로 자동화 초안을 만들고 싶은 분. 자동화 편집기에서 하나씩 검토할 분.
- 지원되는 카메라 소유자. 직접 호스팅하는 비전 모델로 카메라에 무엇이 보이는지 묻고 싶은 분.
확인하지 못한 내용
- 신뢰성. 에이전트가 올바른 엔티티를 찾거나 올바른 자동화를 작성하는 빈도는 테스트하지 않았습니다.
- 안전 관련 설명. Critical Action PIN과, Sentinel에서 모델이 아무것도 작동시키지 않는다는 설명은 개발자의 설명입니다.
- 로컬 모델 품질. 가이드는 모델을 권장하지만 로컬 하드웨어에서의 도구 사용이나 비전 성능 벤치마크는 공개하지 않습니다.
- 데이터 처리. 얼굴 서비스와 클라우드 제공자로 가는 데이터 흐름은 검사하지 않았습니다.
경쟁 제품과 대안
Home Assistant Assist
- 플랫폼:
- Home Assistant(웹, Android, iOS)
- 가격 / 라이선스:
- 무료 / Apache-2.0
- 핵심 차이:
- 음성 파이프라인 내장, LLM 에이전트는 선택 추가
Home Assistant Assist 관련 문서 (1개)
- Home Assistant Assist Review: Local Voice Control and LLM Agents업데이트 2026년 10월 24일
nanobot
- 플랫폼:
- Windows, macOS, Linux
- 가격 / 라이선스:
- 무료 / MIT
- 핵심 차이:
- 범용 셀프호스팅 에이전트, Home Assistant에 묶여 있지 않음
nanobot 관련 문서 (5개)
- Nanobot Review: A Self-Hosted AI Agent Framework업데이트 2026년 10월 30일
- PicoClaw Review: Open-Source AI Agent for Small Devices업데이트 2026년 11월 1일
- Local Coding Assistants, Agents & Workflow Tools Compared (2026): IDE Plugins, Agent Frameworks and Autonomous Agents업데이트 2026년 9월 21일
- Local Chat Apps & Assistants Compared (2026): Desktop, Mobile, Self-Hosted, Assistants and Roleplay업데이트 2026년 9월 20일
- Agentic Inbox Review: A Self-Hosted Email Client With an AI Agent업데이트 2026년 9월 19일
PicoClaw
- 플랫폼:
- Linux, macOS, Windows, Android
- 가격 / 라이선스:
- 무료 / MIT
- 핵심 차이:
- 소형 범용 에이전트, Home Assistant에 묶여 있지 않음
PicoClaw 관련 문서 (1개)
- PicoClaw Review: Open-Source AI Agent for Small Devices업데이트 2026년 11월 1일
같은 스마트홈 분야에 속하는 것은 Home Assistant Assist뿐이며, nanobot과 PicoClaw는 범용 에이전트입니다. 선택하기 전에 각 앱의 최신 가격, 라이선스, 플랫폼을 해당 앱 페이지에서 확인하십시오.
자주 묻는 질문
Home Generative Agent는 Home Assistant Assist를 대체합니까?
아닙니다. Assist 안에서 대화 에이전트로 선택하는 것이며, Assist 파이프라인에 자체 음성 인식·음성 합성 제공자를 추가할 수 있습니다.
에이전트가 기기를 찾을 수 없다고 하는 이유는 무엇입니까?
에이전트는 Assist에 공개된 엔티티만 이름과 영역으로 찾습니다. 그래서 README는 엔티티를 공개하고 분명한 이름과 영역을 지정하라고 권합니다.
Home Assistant Container나 Core에서도 동작합니까?
포함된 데이터베이스 앱은 Home Assistant OS 또는 Supervised가 필요하므로, Container나 Core에서는 설치 가이드가 pgvector가 있는 별도의 PostgreSQL 서버를 안내합니다.
결론
Home Generative Agent는 기존 Home Assistant에, 로컬 Ollama 서버나 클라우드 모델로 동작하는 도구 사용형 AI 에이전트를 무료 MIT 라이선스로 더하는 방법이며, 활발히 유지보수되고 있습니다. 반면 설치는 여러 서비스에 걸쳐 있고, 많은 기능이 얼굴 서비스 같은 선택 구성 요소에 의존하며, PromptQuorum은 신뢰성, 개인정보 동작, 로컬 모델 품질을 테스트하지 않았습니다. HACS와 모델 서버에 익숙한 Home Assistant 사용자에게 적합하며, 잠금장치나 보안 자동화에 쓴다면 생성된 자동화를 하나하나 직접 확인해야 합니다.
자료 출처
- GitHub의 Home Generative Agent — README, MIT 라이선스, 커밋 기록. 2026년 11월 1일 확인.
- 설치 가이드 — HACS 및 수동 설치, 선택 앱, Ollama 모델. 2026년 11월 1일 확인.
- 설정 가이드 — 모델 제공자, 음성, 도구, 옵션. 2026년 11월 1일 확인.
- Home Generative Agent 릴리스 — 2026년 10월 23일의 버전 3.44.10과 파일 목록. 2026년 11월 1일 확인.
- Home Assistant 커뮤니티 스레드 — 프로젝트 공지와 사용자 토론. 2026년 11월 1일 확인.
