히스토리

HomeAgent — 오픈소스 스마트홈 에이전트 플랫폼

비전

달에 보내도 동작할 자립형 시스템. 클라우드 없이, 프라이버시를 지키며, 에이전트와 협업하는 스마트홈.

RPi5 위의 Go 바이너리 하나로 Matter 디바이스를 제어하고, on-device sLLM이 자연어로 집을 관리한다. 이것은 단순한 스마트홈 허브가 아니라, 오프라인 에이전트 협업의 물리적 거점이다.

현재 상태 (2026-03-04)

기술 스택

레이어기술비고
OSYocto Scarthgap 5.0 LTS재현 가능한 이미지
허브Go (단일 바이너리, ~7MB)상태관리, SSE, 에이전트
Mattermatter.js (Node.js)BLE 커미셔닝, Thread+WiFi
프론트엔드Lit WebComponents (~40KB)Vite 빌드
AI 에이전트OpenRouter / on-device sLLMGemini Flash ~$0.02/day
하드웨어RPi5 + Thread RCP (RCP dongle)OTBR 내장

검증된 기능

  • Matter over Thread: Tuya Door Sensor x2
  • Matter over WiFi: Tapo Smart Plug x1
  • LLM 에이전트: 자연어 → 디바이스 제어 (“플러그 꺼줘”)
  • 실시간 SSE 이벤트 스트리밍
  • A2UI: 서버 결정 테마 (시간대별 자동 전환)

로드맵: 해야 할 것들

1. 크로스플랫폼 앱 — Go + Flutter

현재: Lit 웹앱 (브라우저 전용) 목표: Linux + Android 양쪽에서 동작하는 네이티브 앱

Go(백엔드) + Flutter(프론트엔드)로 하면:

  • Linux (RPi5, NixOS): 네이티브 앱
  • Android (월패드, 태블릿): 네이티브 앱
  • meta-flutter (Yocto 레이어)로 임베디드 배포 가능

코틀린은 건드리지 않는다. Go, Zig, TypeScript, Bash로 충분하다. connectedhomeip(CHIP SDK)에서 matter.js로 통일하면 두 플랫폼의 Matter 스택이 같아진다.

2. sLLM 튜닝 — on-device 에이전트

현재: OpenRouter 경유 Gemini Flash 목표: RPi5 위에서 3B~7B 모델이 로컬 추론

  • 디바이스 제어 특화 fine-tuning
  • 인터넷 없이도 “불 꺼줘”가 동작
  • 클라우드 에이전트(glg)와 연결될 때 동기화

3. A2A 프로토콜 — 에이전트 간 통신

Agent-to-Agent.

  • homeagent의 로컬 에이전트 ↔ 클라우드 에이전트(glg, gemini)
  • 디바이스 이벤트를 에이전트 네트워크로 전파
  • 어젠다 타임라인에 IoT 이벤트가 함께 찍히는 세계

4. A2UI — 에이전트 생성 UI

현재: 서버(Go)가 팔레트 결정 → CSS 변수 주입 목표: LLM이 UI 컴포넌트를 선언적으로 생성

5. Yocto 이미지 재현성

SD 카드 플래싱 → 부팅 → 동작. NixOS의 재현가능성 철학과 같은 맥락. npm-shrinkwrap 관리, 오프라인 빌드 지원이 핵심.

생존과 로드맵의 일치

생존해야 되니까 하는 회사 일과 나의 로드맵을 일치시켜야지. 그렇게 해야 가든에 공개가 가능하고 포트폴리오로 기술 커리어를 드러낼 수 있을 것 같아. — 정한, 2026-03-04

회사가 필요로 하는 것(월패드 앱, Matter 디바이스 제어)과 내가 꿈꾸는 것(오프라인 에이전트 플랫폼)이 homeagent-config에서 만난다.

산출물은 오픈소스로. 회사는 로고 박고 필요한 것 넣어서 가져간다. 시간을 파는 것이 아니라, 자기 로드맵 위에서 일하는 것.

sks-hub-zig와의 관계

sks-hub-zig (Zigbee 허브, 22대 DS/SP/LIG 운용)는 레거시 프로토콜 영역. homeagent-config (Matter 허브)는 차세대 프로토콜 영역. 둘 다 “자립형 허브”라는 같은 철학 위에 있다.

sks-hub-zig에서 검증한 것들 — 상태머신 설계, configureReporting, 오프라인 복원 — 이 경험이 homeagent-config의 Matter 레이어에 흘러들어간다.

에이전트 협업 관점에서의 HomeAgent

인간중심 멀티에이전트 협력 봇로그에서 정리한 시나리오:

상황동작하는 에이전트역할
기밀장소, 네트워크 없음HomeAgent sLLM디바이스 제어, 기록
외출, 네트워크 있음glg(Claude) + Gemini리뷰, 보완, 리서치
집, 풀 환경HomeAgent + glg + Gemini + bbot풀 오케스트레이션

HomeAgent는 물리 세계와 디지털 가든을 잇는 다리다.

관련 노트