4.5 KiB
4.5 KiB
Automatisch generiert von OWL am 2026-06-21 Dieses File dient als externes Memory für Hermes Agent NICHT manuell bearbeiten — wird bei jedem Memory-Update überschrieben
KPT-LABS Systemübersicht
🏗️ Architektur
| Komponente | Port | Tech | Status |
|---|---|---|---|
| Dashboard | :3000 | Next.js + SQLite | |
| Hermes Gateway | :8787 | FastAPI | |
| Ollama | :11434 | Lokal | |
| Gitea | intern | Docker |
Hinweis (2026-06-22): LiteLLM Proxy, Redis, Scanner und Memory (ChromaDB) wurden entfernt. KPT-LABS nutzt jetzt Ollama direkt + OpenRouter als Backup. Re-Implementierungsplan für LiteLLM:
05-Dashboard/Ideen/LiteLLM-Re-Implementation.md
📂 Pfade
- Projekt:
E:\OpenCode_Projekte\KPT-LABS - Dashboard:
E:\OpenCode_Projekte\KPT-LABS\dashboard - Database:
E:\OpenCode_Projekte\KPT-LABS\dashboard\data\kptlabs.db - Obsidian Vault:
E:\OpenCode_Projekte\obsidianVault - Logs:
E:\OpenCode_Projekte\KPT-LABS\logs - System Scripts:
E:\OpenCode_Projekte\KPT-LABS\system
🗄️ Database Schema (wichtigste Tabellen)
Core
users— Benutzer (FK@KPT-LABS)sessions— Chat-Sessionsmessages— Nachrichtenprojects— Projektescheduled_tasks— Geplante Tasks (Cron)
YouTube
yt_playlists— Playlistsyt_videos— Videosyt_summaries— KI-Zusammenfassungenyt_ideas— Aus Videos generierte Ideenyt_watcher_state— Watcher Status
Wissensbank
knowledge_entries— Erkenntnissedashboard_ideas— Dashboard-Verbesserungenknowledge_idea_links— Verknüpfungen
Agenten
agents— Agenten-Registry (hermes, youtube-watcher, scout, forge, researcher)agent_activities— Aktivitäten
Token & Provider
token_usage— API-Request-Loggingprovider_health— Provider-Statustoken_budgets— Budget-Limits
Inbox
inbox_entries— Ungefilterte Einträge (text, link, voice, idea)is_selected— Markierungis_archived— Archiv-Statusmoved_to— Wohin verschoben (task/idea)moved_to_id— ID im Zielsystem
🤖 Agenten
| Agent | ID | Funktion |
|---|---|---|
| Hermes | hermes |
Haupt-Agent (Chat, Research, Code) |
| YouTube Watcher | youtube-watcher |
Playlist-Monitoring, Transkription, Summary |
| Scout | scout |
Scannt neue Modelle/Technologien |
| Forge | forge |
Code-Generation, Refactoring |
| Researcher | researcher |
Deep Research, Synthese |
🔑 API-Keys
- OpenRouter: PRIMARY + FALLBACK1 (2 Keys)
- Ollama: Lokal (unbegrenzt, kostenlos)
- NVIDIA: 1 Key
- Google: 1 Key
Multi-Key-Rotation: OpenRouter Primary → Fallback1 → Ollama (lokal)
🖥️ Hardware
- CPU: AMD Ryzen 9 5900X (12C/24T)
- RAM: 64 GB
- GPU: Radeon RX Vega 4GB (kein NVIDIA — keine CUDA)
- OS: Windows 10
🐍 Python
python= Python 3.11.15 (NICHTpython3— das ist MS Store Redirect)uvinstalliertfaster-whisperinstalliert (small model, CPU int8)
📝 .env / Umgebungsvariablen
TELEGRAM_BOT_TOKEN— Fehlt noch! Muss gesetzt werden für Telegram BotCRON_SECRET=kpt-labs-cron-2026
⚠️ Bekannte Issues
yt-dlp
- YouTube Block without cookies → Fix:
--extractor-args "youtube:client=android" - Manchmal 403 Forbidden → Android Client + PO Token
- yt-dlp als CLI hat Venv/urllib3 Konflikte → Workaround: System Python mit clean PATH
Hermes Venv
- Alter urllib3 breaking System Python → Fix:
PYTHONPATH=""prefix
Gitea Push
- Große Repos (>1000 Dateien) → hängt bei git-receive-pack
- Fix: URL-encode creds,
core.compression=0,http.postBuffer=104857600
Next.js TypeScript
- Pre-existing TS Fehler in node_modules (RuleSetUseItem, esModuleInterop etc.)
- Blockieren NICHT den Build — sind in Next.js dependencies
🔧 Tool Quirks (Windows)
patchmit Backtick/SQL Content → Nutzeterminaloderwrite_filewrite_filerelative Pfade → Nutze absolute Windows Pfadepython3→ Nutzepython(3.11.15)jq→ Fehlt, installieren viawingetlsof→ Fehlt unter Windows → Nutzenetstat -ano+taskkill /F /PID- Shell ist git-bash (MSYS) → POSIX Syntax, KEIN PowerShell
🌐 Gitea
- URL:
gitea.intern.kpt-lab.de - Repo:
fk/kpt-labs - Auth: HTTPS, Credentials in Windows Credential Manager
- API: Kann nur Repos erstellen & Release Assets hochladen, NICHT pushen