homeMaker
Your home, managed by AI.
Track house projects, budgets, schedules, IoT sensors, and secrets — with AI agents that research, plan, and organize for you.
Alpha Software --- homeMaker is under active development. Built on the protoLabs Studio platform, adapted for domestic use.
Your household generates a constant stream of projects, purchases, maintenance schedules, and decisions. homeMaker gives you a single self-hosted interface to manage all of it — with AI agents that do the legwork.
Add a task to the board: "Research best smart thermostat for 2000 sq ft house." An AI agent picks it up, searches for options, compares features and prices, and delivers a summary with recommendations. You review and decide.
The same system handles renovation planning (break a kitchen remodel into phased tasks with dependencies), recurring maintenance tracking (HVAC filters, gutter cleaning, lawn care), budget management, IoT sensor monitoring, and encrypted secrets storage.
A Kanban board where AI agents pick up tasks and execute them autonomously. Unlike coding tools, homeMaker agents default to research-and-report mode — they gather information, summarize findings, and make recommendations.
Track every home asset with purchase dates, prices, and current valuations. Monitor warranty expiration with 30-day and 7-day warnings. Link physical items to IoT sensors for automated status monitoring.
Define recurring home obligations (HVAC filters, gutter cleaning, appliance servicing) with interval-based scheduling. Due dates auto-calculate from last completion. Link tasks to vendors and inventory items. Completion history tracks what was done and when.
Manage service provider contacts organized by trade category (plumbing, electrical, HVAC, landscaping, etc.). Store phone numbers, emails, websites, and ratings. Link vendors to maintenance tasks and inventory assets.
A Home Health Score (0--100) calculated across four pillars: Maintenance (30%), Sensors (25%), Budget (25%), and Inventory (20%). Earn XP for completing maintenance tasks, adding inventory items, logging budget entries, and keeping sensors online. Progress through 10 tiers from Novice to Home Champion. Unlock 30 achievements across 6 categories. Maintain streaks for consecutive-day activity. Accept AI-generated quests for bonus XP rewards. Celebration animations on level-ups and achievement unlocks.
Register smart home devices via REST API. Sensors report readings, the system tracks online/stale/offline status with TTL-based detection, and a context aggregator determines household presence (active, idle, away, headless). Command push sends instructions back to devices. Reading history persists to SQLite with configurable retention.
Track household income, expenses, and bills by category. Monthly summaries, category breakdowns, and budget targets — all stored locally in SQLite.
Encrypted local storage for passwords, API keys, WiFi credentials, and home codes. AES-256-GCM encryption at rest. Values never exposed unless explicitly revealed.
Full event management with creation, editing, and detail views. Schedule home maintenance, family events, and project deadlines. Maintenance tasks with upcoming due dates appear automatically.
Subscribe to Home Assistant's WebSocket API to receive state changes from HA entities, mapped to sensor readings automatically. Weather data from OpenWeatherMap displayed in a dashboard widget.
Household notes with tabs, and task lists for quick items that don't need the full board treatment.
git clone https://github.com/protoLabsAI/homeMaker.git
cd homeMaker
npm install
npm run dev:full # Web mode — starts UI (localhost:8578) AND server (localhost:8579)Requires Node.js 22+ and an Anthropic API key.
homeMaker is designed to run on your home network behind Tailscale. No public internet exposure, no login screens — Tailscale handles access control at the network layer.
# Set required environment variables
export HOMEMAKER_VAULT_KEY=$(openssl rand -hex 32) # For secrets vault encryption
export ANTHROPIC_API_KEY=your-key-here
# Run with Docker
docker compose -f docker-compose.homemaker.yml up -dAccess from any Tailscale device at http://homemaker:8578.
See docs/deployment/tailscale.md for the full deployment guide.
You describe a task --> AI agent picks it up --> Researches/plans/organizes --> Reports back --> You review
- Add a task to the board with a natural language description
- Auto-mode assigns an AI agent based on task complexity
- Agent researches, compares, plans, or organizes — whatever the task requires
- Results delivered as a summary you can review and act on
- For code tasks (building new features for homeMaker itself), agents work the same way as protoLabs Studio
Your Home Health Score updates as you complete tasks, maintain sensors, track budgets, and document inventory. The gamification layer turns household upkeep into measurable progress with XP, levels, achievements, and AI-generated quests.
TypeScript monorepo with a React frontend, Express backend, and shared packages. All server services share a single homemaker.db SQLite database (WAL mode, foreign keys enabled).
homeMaker/
├── apps/
│ ├── ui/ # React + Vite frontend (port 8578)
│ └── server/ # Express + WebSocket backend (port 8579)
└── libs/ # Shared packages
├── types/ # Core TypeScript definitions
├── utils/ # Logging, errors, context loading
├── ui/ # Shared UI components (atoms, molecules, theme)
├── prompts/ # AI prompt templates
├── platform/ # Path management, security
├── git-utils/ # Git operations
├── flows/ # LangGraph state graph primitives
├── tools/ # Tool definition and registry
└── ... # model-resolver, dependency-resolver, observability
Key Stack: React 19, Vite 7, Express 5, Claude Agent SDK, TanStack Router, Zustand 5, Tailwind CSS 4, SQLite, Vitest, Playwright
| Variable | Required | Description |
|---|---|---|
ANTHROPIC_API_KEY |
Yes | Anthropic API key for AI agents |
HOMEMAKER_VAULT_KEY |
For vault | 64-char hex key for AES-256-GCM secrets encryption |
AUTOMAKER_API_KEY |
Optional | API key for server authentication |
PORT |
No | Server port (default: 8579) |
HOST |
No | Host to bind to (default: 0.0.0.0) |
DATA_DIR |
No | Data storage directory (default: ./data) |
OPENWEATHERMAP_API_KEY |
Optional | OpenWeatherMap API key |
OPENWEATHERMAP_LAT |
No | Home latitude for weather |
OPENWEATHERMAP_LON |
No | Home longitude for weather |
SENSOR_HISTORY_RETENTION_DAYS |
No | Days of sensor history to retain (default: 30) |
homeMaker is designed for self-hosted, Tailscale-only deployment. It is NOT designed to be exposed to the public internet.
- Secrets are encrypted with AES-256-GCM at rest
- Tailscale provides network-level access control
- API key authentication as a second factor
- Rate limiting on sensitive endpoints
See SECURITY.md for vulnerability reporting.
MIT --- see LICENSE.
Built on protoLabs Studio (MIT).