Repository navigation
HomeNode Agent
The HomeNode Agent is a local LLM running on the HomeNode Server that acts as the intelligent layer of the ecosystem. It understands natural language, reasons about home state, and communicates with users through mChat as a chat bot participant.
All inference is local — no queries leave your home.
- Interprets natural language commands from users in mChat group chats
- Translates commands into HomeNode Server actions ("dim the bedroom to 30%")
- Answers questions about home state ("is the front door locked?")
- Proactively notifies users about relevant events (see below)
The Agent holds its own Nostr keypair and joins mChat group chats as a bot identity. This means it is a first-class participant — it can send and receive messages just like any user.
Example notifications the Agent sends to the group:
- 🚪 "Someone is at the front door" (doorbell / camera)
- 👕 "Washing machine cycle finished"
- 🌡️ "Living room temperature dropped below 18°C"
- 🔒 "Front door was left unlocked for 30 minutes"
- 🚨 "Motion detected in garden at 02:14"
- Receives complex tasks from users via chat and breaks them into HomeNode actions
- Coordinates multi-step automations ("set the house to movie mode")
- Can escalate or ask for clarification when intent is ambiguous
The Agent uses mChatCore — the same library powering the mChat iOS app — to connect to Nostr relays and participate in group conversations. From the relay's perspective, the Agent is just another Nostr identity.
HomeNode Agent
│
│ mChatCore (NostrBackend)
│ Nostr keypair stored on server
▼
Nostr Relay ──► mChat group ──► Users' iPhones
| Repository | Description |
|---|---|
| zehrer/HomeNodeAI | Agent implementation |
| zehrer/mChat | mChatCore — the Nostr library the Agent uses to communicate |
- Architecture — full system diagram
- HomeNode Server — the server the Agent runs on
- mChat — the chat infrastructure the Agent participates in
(c) Stephan Zehrer 2025