62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
# 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 |
|
||
+------+ +---------+
|