Chat with your home in plain English. Aloha reads your entities, writes automations, edits config, debugs what's broken, and operates Home Assistant for you — with a curated library of HA skills and full MCP tool access.
Open source. Bring your own AI key — or use the managed aloha.pushbuild.com.
Home Assistant is the most powerful smart-home platform there is — and almost impossible for a non-technical person to configure. AI coding agents are fluent in HA's YAML, its automations, its quirks. Aloha glues them together: a baked-in agent that administers Home Assistant through a friendly chat UI.
- 🛠️ 76 Home Assistant tools — read/control entities, CRUD automations, edit config files, manage dashboards & HACS, read logs and traces.
- 📚 HA skills — curated playbooks the agent follows for real tasks: set up motion lighting, debug why an automation didn't fire, triage unavailable entities, run a health check, make safe config changes. (Easily extensible.)
- 🔌 MCP, both ways — Aloha exposes its tools as an MCP server and can consume external MCP servers to extend the agent.
- 🤖 Any AI — Anthropic Claude, OpenAI, Gemini, Ollama (local/offline), Groq, OpenRouter, or any OpenAI-compatible endpoint. Bring your own key.
- 🛡️ Safe by default — every config change is shown as a diff for your approval before it's written. Nothing touches your setup without sign-off.
Bring your own AI provider key (or run a local model with Ollama — fully offline, no account). You own everything; nothing phones home.
git clone https://github.com/sackio/aloha.git
cd aloha
docker compose up -d --build- Aloha UI: http://your-host:7123 · Home Assistant: http://your-host:8123
Already running Home Assistant? Point Aloha at it instead of bundling one:
docker run -d --name aloha -p 7123:7123 \
-e ALOHA_MODE=standalone -e ALOHA_HA_URL=http://your-ha:8123 \
-v aloha-data:/data ghcr.io/sackio/aloha:latest # prebuilt images coming soonAlso ships as a Home Assistant OS add-on (haos-addon/) — Supervisor injects
the HA token automatically.
Don't want to deal with API keys and billing? Use the hosted agent at aloha.pushbuild.com — pick "Aloha managed" in the setup wizard, sign in, and you're chatting with your home. Flat monthly with generous usage. (In active development.)
Open the Aloha UI and the wizard walks you through picking an AI provider and connecting to Home Assistant. Then just ask:
"What lights are on right now?" "Create a bedtime routine that locks the doors and turns off the lights at 11pm." "Why didn't my away-mode automation fire yesterday?" "Set up motion-activated lighting in the hallway."
Aloha exposes its full tool suite over the Model Context Protocol:
claude mcp add aloha http://your-host:7123/mcpUse Claude Code, Cursor, or any MCP client to manage your home from your editor.
┌──────────────────────── one container ────────────────────────┐
│ Home Assistant (:8123) ◄──localhost── Aloha agent (:7123) │
│ FastAPI + React UI │
│ agent loop → 76 tools │
│ skills · MCP client │
│ shared volume: /data (HA config + Aloha settings/sessions) │
└────────────────────────────────────────────────────────────────┘
Provider-agnostic agent loop, multi-step tool use, and a diff→approve safety gate.
Aloha is under active development. The agent, tools, skills, MCP support, and the Docker/standalone/add-on paths work today; prebuilt multi-arch images, the Raspberry Pi image, and the managed tier are in progress.
Issues and PRs welcome. Skills are just markdown files in aloha/skills/library/ —
adding one is a great first contribution.
Questions, feedback, or interested in the managed tier? Reach us through the contact form at aloha.pushbuild.com, or open a GitHub issue.
MIT — see LICENSE.