fk/kpt-labs-vault
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
kpt-labs-vault/05-Dashboard/README-FIRST.md
Floki 38f3a4485a 📊 auto-update: system snapshot 2026-06-22
2026-06-22 17:00:36 +02:00

2.9 KiB
Raw Blame History

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

# 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