# Wrightstown Smart Home - Project Index

**Project:** Smart Home + Local LLM + Hybrid AI Bridge
**Location:** Wrightstown (home)
**Status:** Planning / Research Phase
**Created:** 2026-02-09
**Last Updated:** 2026-02-09

**Related Project:** `projects/wrightstown-solar/` (Victron integration crossover)

---

## Project Overview

Privacy-first smart home system using Home Assistant Yellow with local voice control, a dedicated local LLM server, and a hybrid routing bridge that keeps private data local while leveraging Claude and Grok APIs for tasks requiring external search or heavy reasoning.

## Design Goals

1. No Google/Alexa dependency -- fully local voice control
2. Local LLM for private queries (home automation, sensor data, cameras)
3. Hybrid bridge to Claude API (reasoning) and Grok API (internet search)
4. Privacy-first: private data never leaves the network
5. Network segmentation (VLANs) for IoT isolation
6. Integration with Victron solar system (future crossover with wrightstown-solar project)

## Hardware Inventory

| Component | Status | Notes |
|---|---|---|
| Home Assistant Yellow | Owned (not set up) | Needs CM4/CM5 module |
| LLM Server | Not purchased | RTX 4090 build recommended |
| Network gear (VLANs) | TBD | Ubiquiti or TP-Link Omada |
| Wyoming voice satellites | Not purchased | For room-by-room voice control |

## Architecture

```
            Voice Satellites (Wyoming)
                    |
            [Home Assistant Yellow]
              /     |        \
        Zigbee    Victron    LLM Integration
        devices   Modbus     (Extended OpenAI Conversation)
                                |
                        [LiteLLM Proxy]
                         (routing layer)
                        /       |       \
                  [Ollama]  [Claude]  [Grok]
                  Local     Anthropic  xAI
                  $0/mo     API        API
                  Private   Reasoning  Search
```

---

## Files

### Documentation
| File | Description |
|---|---|
| `documentation/ha-yellow-setup.md` | Home Assistant Yellow setup and voice assistant config |
| `documentation/llm-server-build.md` | Local LLM server hardware, software, and model selection |
| `documentation/hybrid-bridge.md` | LiteLLM routing, Claude/Grok API integration, privacy layer |
| `documentation/network-security.md` | VLAN architecture, IoT isolation, PII sanitization |

### Session Logs
| File | Description |
|---|---|
| `session-logs/2026-02-09-session.md` | Initial research and planning session |

---

## Budget Estimate

### Phase 1: Home Assistant Yellow Setup
| Component | Est. Cost |
|---|---|
| RPi CM4 4GB/32GB (if not owned) | $45-75 |
| NVMe SSD (512GB-1TB) | $40-80 |
| **Phase 1 Total** | **$45-155** (Yellow already owned) |

### Phase 2: LLM Server (Sweet Spot Build)
| Component | Est. Cost |
|---|---|
| RTX 4090 24GB | $1,200-1,500 |
| Ryzen 7 5800X3D + B550 + 64GB DDR4 | $490 |
| Storage, PSU, case | $190 |
| **Phase 2 Total** | **$1,880-2,180** |

### Phase 3: Network + Voice
| Component | Est. Cost |
|---|---|
| VLAN-capable router + managed switch | $150-760 |
| Wyoming voice satellites (2-3 rooms) | $100-200 |
| **Phase 3 Total** | **$250-960** |

### Ongoing Monthly
| Item | Est. Cost |
|---|---|
| Cloud API (Claude + Grok, 80/15/5 split) | ~$5/mo |
| Electricity (LLM server) | ~$15-30/mo |
| **Monthly Total** | **~$20-35/mo** |

---

## Decision Log

| Date | Decision | Rationale |
|---|---|---|
| 2026-02-09 | Home Assistant over Google/Alexa | Privacy, local control, open source |
| 2026-02-09 | HA Yellow (already owned) | Built-in Zigbee, NVMe slot, still receives updates |
| 2026-02-09 | Ollama for local LLM | Simplest setup, OpenAI-compatible API, huge model library |
| 2026-02-09 | LiteLLM for hybrid routing | Unified API, cost tracking, fallback support |
| 2026-02-09 | Claude API for reasoning | Best quality reasoning, function calling for HA |
| 2026-02-09 | Grok API for search | Internet access, 2M token context, X integration |
| 2026-02-09 | Separate project from solar | Different build timelines, but Victron crossover planned |

---

## Implementation Roadmap

- [ ] **Phase 1 (Week 1-2):** Set up HA Yellow, basic automations, Zigbee devices
- [ ] **Phase 2 (Week 3):** Install Wyoming + Whisper + Piper for local voice
- [ ] **Phase 3 (Week 4):** Build LLM server, install Ollama, test models
- [ ] **Phase 4 (Week 5):** Set up LiteLLM proxy, add Claude + Grok API keys
- [ ] **Phase 5 (Week 6):** Integrate LLM with HA via Extended OpenAI Conversation
- [ ] **Phase 6 (Week 7):** Network segmentation (VLANs), PII sanitization
- [ ] **Phase 7 (Future):** Victron solar integration (crossover with wrightstown-solar)

---

## Crossover with Wrightstown Solar

When the Victron MultiPlus II + Cerbo GX are installed:
- Modbus TCP integration from Cerbo into Home Assistant
- Energy dashboard with solar production + battery SOC
- Solar-aware automations ("run dishwasher when battery > 80%")
- LLM-powered energy analysis ("analyze my usage trends this week")
- See: `projects/wrightstown-solar/` for full solar system design
