GitHub

Local-first home operations

Stop keeping your home in your head.

A local-first system with specialized agents, a SecondBrain vault, and approval-gated actions.

Alpha 5 (current): agent teams, SecondBrain, approvals, signed contract events, hash-only anchors, Railgun linkage metadata.

See Alpha 5 Install locally
Current release

Built for real operations

Alpha 5 ships coordination plus signed contract events and optional chain anchors.

  • SecondBrain vault with memory graph
  • Agent teams + scheduler templates
  • Approval queue + signed contract event ledger
  • Hash-only anchors (Polygon default)
  • ZK linkage metadata (Railgun nullifier/commitment)
Core systems Integrity

Runs locally. No signup required.

Every action is approval-gated.

Proofs are hash-only; payloads stay private.

Alpha 5 release summary

The current version focuses on coordination, proofs, and operational depth.

Agent coordination teams

Pre-built teams for finance review, maintenance dispatch, security response, and project planning.

SecondBrain vault + memory graph

Decisions, documents, and logs stored in an Obsidian-compatible vault with graph view.

Manager chat with reasoning

Talk to the Manager, see the reasoning trace, and issue quick commands.

Scheduler + job templates

Daily and weekly runs with templates for finance reviews, maintenance checks, and security audits.

Live system dashboard

Current status for agents, connectors, memory, anchor queue, and scheduled jobs.

Proof layer + Railgun linkage

Signed contract events + hash-only anchors, plus payment linkage records (acceptance hash, nullifier, commitment).

Business workflows

Relationships, contracts, invoices, and payment approvals built into the core app.

Core systems shipping now

The foundational systems in the current build.

SecondBrain memory vault

Stores decisions, notes, documents, and service history.

Unified inbox

Gmail + WhatsApp ingestion with normalization and deduplication.

Agent scheduler

Create recurring jobs and run templates on demand.

Live system dashboard

Agent activity, connector health, and job status in one view.

Memory graph view

Explore SecondBrain connections with filters and search.

Setup wizard

Guided onboarding for budgets, connectors, and notifications.

Integrity and ZK linkage

Local-first proofs with optional on-chain anchors and ZK linkage metadata.

What is proven

  • Approvals and decisions
  • Contracts, milestones, change orders, evidence
  • Payment requests, intents, receipts, linkages
  • Invoices and invoice payments (business)
  • Maintenance completions and backups

How proofs work

  • Canonical JSON hashing (SHA-256)
  • Signed contract events with local identity keys (Ed25519)
  • Hash-only anchors to Polygon (default)
  • ZK linkage fields: acceptance hash, nullifier, commitment
  • Payment linkage can be anchored as payment_linkage events
  • Diagnostics show anchor status and Railgun health

Anchors store hashes only; payloads remain local. Railgun linkage metadata is recorded and configurable in Settings.

Business workflows

Structured agreements, payments, and proofs for professional operations.

Relationships

Manage counterparties, roles, and permissions for shared work.

Contracts + milestones

Define scope, acceptance criteria, and evidence for work delivery.

Invoices (business edition)

Create invoices, line items, and payment status tracking.

Payments + receipts

Approval-gated payment requests, receipts, and optional chain anchors.

Note: invoice tooling is available in the business edition.

Agents that handle the work

Eight specialized agents cover the core areas of home operations.

Manager Agent (Galidima)

Routes requests, coordinates the others, and reports system status.

Finance Agent (Mamadou)

Tracks bills, budgets, portfolio holdings, and cash flow.

Maintenance Agent (Ousmane)

Tracks service history, seasonal tasks, and maintenance schedules.

Contractors Agent (Malik)

Stores providers, quotes, and follow-ups for external work.

Projects Agent (Zainab)

Breaks home projects into steps, timelines, and dependencies.

Security Manager (Aicha)

Tracks incidents and enforces approval gates on sensitive actions.

Janitor Agent (Salimata)

Audits system health, specs, and data integrity.

Backup and Recovery (Backup)

Creates backups and restores data when needed.

Roadmap

Tracked in the repo but not fully shipped yet.

In progress

  • Bank connector (CSV/OFX import)
  • Home Assistant integration
  • Ring Doorbell integration
  • Semantic search for SecondBrain
  • Scheduler notifications (WhatsApp/email)

Planned

  • Conversation branching UI
  • Bill tracking and reminders
  • Voice interface
  • Mobile app
  • Multi-tenant support

Install

Runs locally. No signup required.

Requirements: Python 3.11+, Node.js 18+, Git

  1. Recommended (wizard)

    cd /path/to/mycasa-pro
cp .env.example .env
./mycasa setup

  2. Open the app

    http://127.0.0.1:3000

  3. Manual (two terminals)

    macOS / Linux 
    cd /path/to/mycasa-pro
cp .env.example .env
python3 -m venv .venv
source .venv/bin/activate
python install.py install

# Backend (terminal 1)
export MYCASA_API_BASE_URL=http://127.0.0.1:6709
export MYCASA_BACKEND_PORT=6709
export MYCASA_CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000
python -m uvicorn api.main:app --host 127.0.0.1 --port 6709

# Frontend (terminal 2)
cd frontend
echo "NEXT_PUBLIC_API_URL=http://127.0.0.1:6709" > .env.local
npm install
npm run dev
    Windows PowerShell 
    cd C:\path\to\mycasa-pro
copy .env.example .env
py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python install.py install

# Backend (terminal 1)
$env:MYCASA_API_BASE_URL="http://127.0.0.1:6709"
$env:MYCASA_BACKEND_PORT="6709"
$env:MYCASA_CORS_ORIGINS="http://localhost:3000,http://127.0.0.1:3000"
python -m uvicorn api.main:app --host 127.0.0.1 --port 6709

# Frontend (terminal 2)
cd frontend
"NEXT_PUBLIC_API_URL=http://127.0.0.1:6709" | Out-File -Encoding utf8 .env.local
npm install
npm run dev

  4. URLs

    UI: http://127.0.0.1:3000

    API: http://127.0.0.1:6709

    API Docs: http://127.0.0.1:6709/docs

  5. LLM provider (default Qwen)

    ./mycasa llm qwen-login

    Default model: qwen3-coder-plus. OpenAI/Anthropic keys can be added in Settings.

  6. Connectors (user-owned credentials)

    Gmail + Google Calendar (gog)

    brew install doitintl/tap/gog
gog auth login

    WhatsApp (wacli)

    npm install -g @nicholasoxford/wacli
wacli auth

  7. Optional (LAN access)

    MYCASA_PUBLIC_HOST=<your-lan-ip> MYCASA_BIND_HOST=0.0.0.0 ./start_all.sh

Built in the open

The code and architecture live in a public GitHub repository so you can inspect how it works.

View on GitHub