pueo

Pueo is an autonomous AI agent that monitors Home Assistant (HA) instances to identify and fix issues without requiring constant user intervention. It operates entirely on-device using Ollama for local inference, ensuring privacy and reducing reliance on cloud APIs. Key capabilities include: - Vigilant Monitoring: Streams live HA logs via SSH and triages entries using a local AI model. - Adaptive Diagnostics: Uses an iterative tool-calling loop to analyze configuration files, run health checks, and identify root causes. - Self-Healing: Proposes fixes that are sandbox-tested and applied only after creating a native HA backup snapshot. - Local RAG Knowledge Base: Utilizes ChromaDB to store and query HA release notes, HACS changelogs, and integration documentation locally. - Interactive Dashboard: Provides a web interface at port 8080 for reviewing repair actions, viewing event timelines, and chatting with the agent to query live HA state or store persistent notes. - Personalized Update Analysis: Analyzes available HA updates against the user's specific configuration to identify relevant breaking changes. The system can be deployed natively on macOS or via Docker and supports a structured 6-phase investigation cycle (retrieve context, form hypothesis, gather evidence, confirm root cause, act, and report).