76 lines
2.9 KiB
Markdown
76 lines
2.9 KiB
Markdown
# 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
|