# Project: Jarvis – Personal Homelab Assistant

## 1. Vision

Build a **personal “Jarvis” assistant** that runs its **brain on the server (LLM)** and uses **lightweight clients** on your machines (desktop, Unraid, etc.) to:

- Monitor system health (containers, disks, CPU/GPU, services).
- Surface relevant info when you log in (tasks, alerts, emails).
- Execute safe, high-level commands (open apps, organize files, run scripts).
- Eventually feel like a **real assistant**, not just a smart speaker.

---

## 2. Goals & Non-Goals

### 2.1 Goals

- ✅ Central “brain” that understands:
  - System status (servers, containers, resources).
  - Personal context (tasks, projects, important emails).
- ✅ Multiple clients (desktop, server, etc.) sending telemetry and executing actions.
- ✅ Natural language front-end:
  - CLI chat at first (voice later).
  - Greeting on Windows login with a status summary.
- ✅ Safe, auditable actions:
  - File organizing in whitelisted directories.
  - Opening apps / scripts.
  - Reporting server issues proactively.

### 2.2 Non-Goals (for early versions)

- ❌ Full smart-home integration (lights, thermostats, etc.).
- ❌ Generic “AI for everything” (keep it focused on **your** workflow).
- ❌ Full voice assistant (wake word, STT/TTS) in v0.x. Nice-to-have later.
- ❌ Direct shell access for the LLM (no raw `cmd / bash` execution).

---

## 3. High-Level Architecture

```text
+-------------------------+
|      LLM Brain          |
|  (Server on Unraid)     |
+-----------+-------------+
            ^
            | HTTP / JSON
            v
+-----------+-------------+
|  Controller / API       |
|  (FastAPI or similar)   |
+-----------+-------------+
            ^
            |
   +--------+--------+
   |                 |
   v                 v
+------+        +---------+
|Client|        |Client   |
|Win10 |        |Unraid   |
|Desktop       |Agent     |
+------+        +---------+