# KPT-LABS — README First für Opencode

> **Stand**: 2026-06-22 16:00
> **Nächster Agent**: OWL (CEO/Projektleiter)

## 🎯 Projektübersicht

KPT-LABS ist ein Multi-Agent AI Dashboard mit zentralem Kommandozentrum.

## 🏗️ Aktuelle Architektur

```
┌─────────────────────────────────────────────────────────────┐
│                    KPT-LABS Agent OS                         │
├─────────────────────────────────────────────────────────────┤
│  Dashboard :3000 (Next.js + SQLite)                         │
│  Ollama :11434 (lokal, kostenlos)                           │
│  OpenRouter (API Keys in dashboard/.env)                    │
│  Obsidian Vault (Second Brain)                              │
└─────────────────────────────────────────────────────────────┘
```

## 🔑 API Key Rotation

- **Dashboard**: http://localhost:3000/dashboard/system
- **Rotation Chain**: Key+Model Kombinationen in Reihenfolge
- **Auto-Rotation**: Bei 429 automatisch zum nächsten Key
- **Provider**: OpenRouter, NVIDIA, Ollama (lokal), Ollama Cloud

## 📂 Wichtige Pfade

- **Projekt**: `E:\OpenCode_Projekte\KPT-LABS`
- **Dashboard**: `E:\OpenCode_Projekte\KPT-LABS\dashboard`
- **API Keys Config**: `E:\OpenCode_Projekte\KPT-LABS\dashboard\.env`
- **Database**: `E:\OpenCode_Projekte\KPT-LABS\dashboard\data\kptlabs.db`
- **Obsidian Vault**: `E:\OpenCode_Projekte\obsidianVault`
- **System Scripts**: `E:\OpenCode_Projekte\KPT-LABS\system`
- **System Memory**: `E:\OpenCode_Projekte\obsidianVault\05-Dashboard\System-Memory.md`

## 🚀 Quick Start

```bash
# Dashboard starten (Dev Mode)
cd E:\OpenCode_Projekte\KPT-LABS\dashboard
npm run dev

# Dashboard bauen (Production)
npm run build
npm start

# Ollama prüfen
curl http://localhost:11434/api/tags
```

## 📝 Regeln für Opencode

1. **Immer im Projekt-Root**: `E:\OpenCode_Projekte\KPT-LABS`
2. **Port 3000 muss frei sein** vor dem Start
3. **Keine API-Keys in Code hardcoden** — immer `.env` nutzen
4. **DB-Änderungen**: Migration-Script in `system/migrations/` erstellen
5. **Nach großen Änderungen**: Vault committen
6. **Session Compression**: Bei langen Sessions Zusammenfassung erstellen

## ⚠️ Bekannte Issues

1. **Next.js TS Errors** — Dependencies haben TS Probleme (strict: false als Workaround)
2. **Ollama Cloud** — Braucht API Key für ollama.com
3. **Session Compression UI** — Noch nicht im Dashboard implementiert

## 🔄 Nächste Schritte

1. Session Compression UI Button im Dashboard
2. Telegram Bot 2 — /key rotate Command
3. Automatische Rotation bei 429 (Cron-Job)
4. Context Memory Link für OWL