# 🤖 KPT-LABS Agent OS Framework

> Agent OS Dashboard mit Multi-Agent-Support, Token-Tracking & Provider-Health

## Übersicht

| Eigenschaft | Wert |
|-------------|------|
| **Typ** | Next.js Dashboard |
| **Port** | :5555 |
| **Datenbank** | SQLite (better-sqlite3) |
| **Auth** | Session-basiert (Middleware → /login) |
| **Provider** | OpenRouter API |
| **Tech-Stack** | Next.js, React, TypeScript, Tailwind CSS |

## Architektur

### Kern-Komponenten
- **Key Manager** – API-Key Rotation, 3-Tier-Fallback, Priority-Sortierung
- **Provider Display** – Model-Definitionen, Pricing, RPM/TPM-Limits
- **Chat Route** – Retry-Loop, Token-Tracking, Provider-Health
- **System Status** – Services, Models, Token Usage, Provider Health

### Datenbank-Schema
- `api_keys` – API-Schlüssel mit Preferred Models & Priority
- `token_usage` – Token-Verbrauch pro Request
- `provider_health` – Erfolgsrate, Latenz, Cooldown
- `token_budgets` – Budget-Limits
- `model_latency` – Latenz-Tracking pro Modell
- `scheduled_tasks` – Cron-Jobs
- `agent_teams` / `team_members` – Multi-Agent-Teams
- `session_exports` – Session-Exporte

## Features

### Phase 1 ✅
- Mehrsprachige UI (DE/EN)
- API-Key-Rotation mit 3-Tier-Fallback
- Modell-Fallback pro Provider
- Retry mit Exponential Backoff

### Phase 2 ✅
- Token-Usage-Tracking
- Provider-Health-Monitoring
- Modell-Kosten-Kalkulation
- Session-ID-Unterstützung

### Phase 3 ✅ (Mittlere Priorität)
- Scheduled Tasks (Cron-System)
- Multi-Agent-Sessions (Teams)
- Session Export/Import
- Model Response Time Tracking

### Phase 4 🔄 (In Arbeit)
- **Auto-Session-Save → Obsidian**
- Context-Window-Optimierung
- Obsidian Vault Integration

## Docker-Services
| Service | Port | Status |
|---------|------|--------|
| LiteLLM Proxy | :4000 | 🟢 |
| Redis | :6379 | 🟢 |
| Scanner | - | 🟢 |
| Memory | :5002 | 🟢 |

---
*Tags: #kpt-labs #agent-os #nextjs #dashboard #projekt*