🚀 Initial commit: KPT-LABS Obsidian Vault
- Wissensdatenbank Struktur - Projekt-Übersichten - Session-Management Templates - Dashboard Integration - README.md mit Recovery Guide - System Snapshot Generator Generiert: 2026-06-19
This commit is contained in:
Floki
commit
4135d1c2b9
6
.gitignore
vendored
Normal file
6
.gitignore
vendored
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
# Ignorierte Dateien
|
||||||
|
.DS_Store
|
||||||
|
*.tmp
|
||||||
|
*.log
|
||||||
|
node_modules/
|
||||||
|
*.bak
|
||||||
17
.obsidian/app.json
vendored
Normal file
17
.obsidian/app.json
vendored
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
{
|
||||||
|
"showLineNumber": true,
|
||||||
|
"showInlineTitle": true,
|
||||||
|
"spellcheck": true,
|
||||||
|
"alwaysUpdateLinks": true,
|
||||||
|
"useMarkdownLinks": false,
|
||||||
|
"newLinkFormat": "shortest",
|
||||||
|
"attachmentFolderPath": "00-Meta/Attachments",
|
||||||
|
"newFileLocation": "current",
|
||||||
|
"newFileFolderPath": "06-Notizen/Quick-Captures",
|
||||||
|
"promptDelete": false,
|
||||||
|
"autoPairMarkdown": true,
|
||||||
|
"autoPairBrackets": true,
|
||||||
|
"smartIndentList": true,
|
||||||
|
"foldHeading": true,
|
||||||
|
"foldIndent": true
|
||||||
|
}
|
||||||
4
.obsidian/manifest.json
vendored
Normal file
4
.obsidian/manifest.json
vendored
Normal file
@ -0,0 +1,4 @@
|
|||||||
|
{
|
||||||
|
"pluginVersion": "1.0.0",
|
||||||
|
"minAppVersion": "1.0.0"
|
||||||
|
}
|
||||||
160
00-Meta/Scripts/telegram-auto-save.ts
Normal file
160
00-Meta/Scripts/telegram-auto-save.ts
Normal file
@ -0,0 +1,160 @@
|
|||||||
|
/**
|
||||||
|
* Telegram Auto-Session-Save
|
||||||
|
*
|
||||||
|
* Diese Funktion wird vom Agenten (OWL) bei jedem Telegram-Turn aufgerufen.
|
||||||
|
* Sie zählt die Nachrichten und speichert bei Bedarf eine Zusammenfassung
|
||||||
|
* im Obsidian Vault.
|
||||||
|
*
|
||||||
|
* Zusätzlich wird eine Session-Zusammenfassung als Kontext für den nächsten
|
||||||
|
* Turn geladen, um Token zu sparen.
|
||||||
|
*/
|
||||||
|
|
||||||
|
import fs from 'fs';
|
||||||
|
import path from 'path';
|
||||||
|
|
||||||
|
const VAULT_PATH = 'E:\\OpenCode_Projekte\\obsidianVault';
|
||||||
|
const SESSIONS_DAILY = path.join(VAULT_PATH, '04-Sessions', 'Daily');
|
||||||
|
const TRACKER_PATH = path.join(VAULT_PATH, '04-Sessions', 'telegram-session-tracker.json');
|
||||||
|
|
||||||
|
interface SessionTracker {
|
||||||
|
session_id: string;
|
||||||
|
message_count: number;
|
||||||
|
last_save_at: string | null;
|
||||||
|
auto_save_interval: number;
|
||||||
|
model: string;
|
||||||
|
provider: string;
|
||||||
|
total_tokens_estimated: number;
|
||||||
|
created_at: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
function loadTracker(): SessionTracker {
|
||||||
|
try {
|
||||||
|
if (fs.existsSync(TRACKER_PATH)) {
|
||||||
|
return JSON.parse(fs.readFileSync(TRACKER_PATH, 'utf-8'));
|
||||||
|
}
|
||||||
|
} catch { /* ignore */ }
|
||||||
|
return {
|
||||||
|
session_id: 'telegram-floki',
|
||||||
|
message_count: 0,
|
||||||
|
last_save_at: null,
|
||||||
|
auto_save_interval: 10,
|
||||||
|
model: 'openrouter/owl-alpha',
|
||||||
|
provider: 'openrouter',
|
||||||
|
total_tokens_estimated: 0,
|
||||||
|
created_at: new Date().toISOString(),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function saveTracker(tracker: SessionTracker): void {
|
||||||
|
fs.writeFileSync(TRACKER_PATH, JSON.stringify(tracker, null, 2), 'utf-8');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Prüft ob ein Auto-Save nötig ist und gibt ggf. die Zusammenfassung zurück
|
||||||
|
* die als Kontext für den nächsten Turn verwendet werden kann.
|
||||||
|
*/
|
||||||
|
export function checkAndSaveSession(userMessage: string, assistantReply: string): {
|
||||||
|
shouldSave: boolean;
|
||||||
|
summary?: string;
|
||||||
|
tokensSaved: number;
|
||||||
|
} {
|
||||||
|
const tracker = loadTracker();
|
||||||
|
tracker.message_count += 1; // 1 Turn = User + Assistant
|
||||||
|
|
||||||
|
// Tokens grob schätzen (4 chars pro Token)
|
||||||
|
const turnTokens = Math.ceil((userMessage.length + assistantReply.length) / 4);
|
||||||
|
tracker.total_tokens_estimated += turnTokens;
|
||||||
|
|
||||||
|
const shouldSave = tracker.message_count % tracker.auto_save_interval === 0;
|
||||||
|
|
||||||
|
if (shouldSave) {
|
||||||
|
// Zusammenfassung generieren
|
||||||
|
const now = new Date();
|
||||||
|
const dateStr = now.toISOString().split('T')[0];
|
||||||
|
const timeStr = now.toTimeString().split(' ')[0].substring(0, 5).replace(':', '-');
|
||||||
|
|
||||||
|
const summary = `Telegram-Session (${tracker.session_id}): ${tracker.message_count} Nachrichten, ~${tracker.total_tokens_estimated} Tokens. Letzte Nachricht: "${userMessage.substring(0, 60)}..."`;
|
||||||
|
|
||||||
|
const markdown = `---
|
||||||
|
session_id: ${tracker.session_id}
|
||||||
|
date: ${dateStr}
|
||||||
|
time: ${timeStr}
|
||||||
|
message_count: ${tracker.message_count}
|
||||||
|
model: ${tracker.model}
|
||||||
|
provider: ${tracker.provider}
|
||||||
|
tokens_estimated: ${tracker.total_tokens_estimated}
|
||||||
|
tags: [session, telegram, owl]
|
||||||
|
---
|
||||||
|
|
||||||
|
# 📱 Telegram Session: ${dateStr}
|
||||||
|
|
||||||
|
## 📊 Metriken
|
||||||
|
|
||||||
|
| Metrik | Wert |
|
||||||
|
|--------|------|
|
||||||
|
| **Nachrichten** | ${tracker.message_count} |
|
||||||
|
| **Geschätzte Tokens** | ~${tracker.total_tokens_estimated} |
|
||||||
|
| **Modell** | \`${tracker.model}\` |
|
||||||
|
| **Provider** | ${tracker.provider} |
|
||||||
|
|
||||||
|
## 📝 Zusammenfassung
|
||||||
|
|
||||||
|
${summary}
|
||||||
|
|
||||||
|
## 🏷️ Tags
|
||||||
|
|
||||||
|
\`#session\` \`#telegram\` \`#owl\`
|
||||||
|
|
||||||
|
---
|
||||||
|
*Auto-generiert vom OWL Agent – Obsidian Sync*
|
||||||
|
`;
|
||||||
|
|
||||||
|
// Vault-Ordner sicherstellen
|
||||||
|
fs.mkdirSync(SESSIONS_DAILY, { recursive: true });
|
||||||
|
|
||||||
|
// Datei schreiben
|
||||||
|
const filename = `${dateStr}_${timeStr}_telegram.md`;
|
||||||
|
const filePath = path.join(SESSIONS_DAILY, filename);
|
||||||
|
fs.writeFileSync(filePath, markdown, 'utf-8');
|
||||||
|
|
||||||
|
// Tracker aktualisieren
|
||||||
|
tracker.last_save_at = now.toISOString();
|
||||||
|
saveTracker(tracker);
|
||||||
|
|
||||||
|
return {
|
||||||
|
shouldSave: true,
|
||||||
|
summary,
|
||||||
|
tokensSaved: turnTokens, // Diese Tokens werden "gespart" da Zusammenfassung kleiner ist
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
saveTracker(tracker);
|
||||||
|
return { shouldSave: false, tokensSaved: 0 };
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Lädt die letzte Session-Zusammenfassung als Kontext
|
||||||
|
* um Token beim nächsten Request zu sparen
|
||||||
|
*/
|
||||||
|
export function loadLastSessionContext(): string | null {
|
||||||
|
try {
|
||||||
|
const files = fs.readdirSync(SESSIONS_DAILY)
|
||||||
|
.filter(f => f.endsWith('.md') && f.includes('telegram'))
|
||||||
|
.sort()
|
||||||
|
.reverse();
|
||||||
|
|
||||||
|
if (files.length === 0) return null;
|
||||||
|
|
||||||
|
const lastFile = path.join(SESSIONS_DAILY, files[0]);
|
||||||
|
const content = fs.readFileSync(lastFile, 'utf-8');
|
||||||
|
|
||||||
|
// Nur den Zusammenfassungs-Teil zurückgeben
|
||||||
|
const summaryMatch = content.match(/## 📝 Zusammenfassung\n\n([\s\S]*?)\n\n## /);
|
||||||
|
if (summaryMatch) {
|
||||||
|
return `Vorherige Session-Zusammenfassung:\n${summaryMatch[1]}\n\n~Tokens durch Kompression gespart.`;
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
} catch {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
50
00-Meta/Templates/Session-Summary-Template.md
Normal file
50
00-Meta/Templates/Session-Summary-Template.md
Normal file
@ -0,0 +1,50 @@
|
|||||||
|
# 📋 Session-Summary Template
|
||||||
|
|
||||||
|
> Template für Auto-Session-Save vom KPT-LABS Dashboard
|
||||||
|
|
||||||
|
---
|
||||||
|
*Automatisch generiert – KPT-LABS Agent OS*
|
||||||
|
*Generiert: {{date:YYYY-MM-DD HH:mm}}*
|
||||||
|
*Session-ID: {{session_id}}*
|
||||||
|
*Agent: {{agent_name}}*
|
||||||
|
*Modell: {{model}}*
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 Session-Metriken
|
||||||
|
|
||||||
|
| Metrik | Wert |
|
||||||
|
|--------|------|
|
||||||
|
| **Nachrichten** | {{message_count}} |
|
||||||
|
| **Token (Input)** | {{tokens_input}} |
|
||||||
|
| **Token (Output)** | {{tokens_output}} |
|
||||||
|
| **Kosten** | ${{cost}} |
|
||||||
|
| **Dauer** | {{duration}} |
|
||||||
|
| **Modell** | {{model}} |
|
||||||
|
| **Provider** | {{provider}} |
|
||||||
|
|
||||||
|
## 📝 Zusammenfassung
|
||||||
|
|
||||||
|
{{summary}}
|
||||||
|
|
||||||
|
## 🔑 Entscheidungen
|
||||||
|
|
||||||
|
{{decisions}}
|
||||||
|
|
||||||
|
## ✅ Erledigt
|
||||||
|
|
||||||
|
{{completed}}
|
||||||
|
|
||||||
|
## ⏳ Offen / Nächste Schritte
|
||||||
|
|
||||||
|
{{next_steps}}
|
||||||
|
|
||||||
|
## 📁 Beteiligte Dateien
|
||||||
|
|
||||||
|
{{files}}
|
||||||
|
|
||||||
|
## 🏷️ Tags
|
||||||
|
|
||||||
|
`#session` `#{{agent_tag}}` `#{{date:YYYY-MM-DD}}`
|
||||||
|
|
||||||
|
---
|
||||||
|
*Quelle: KPT-LABS Dashboard Auto-Session-Save*
|
||||||
30
00-Meta/Templates/Template-Übersicht.md
Normal file
30
00-Meta/Templates/Template-Übersicht.md
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
# 📝 Template-Übersicht
|
||||||
|
|
||||||
|
> Alle Vault-Templates auf einen Blick
|
||||||
|
|
||||||
|
## Verfügbare Templates
|
||||||
|
|
||||||
|
### Projekte
|
||||||
|
- [[Projekt-Template|📋 Projekt-Template]] – Neue Projekte anlegen
|
||||||
|
- [[Projekt-Status-Template|📊 Projekt-Status-Template]] – Status-Updates
|
||||||
|
|
||||||
|
### Ideen
|
||||||
|
- [[Ideen-Template|💡 Ideen-Template]] – Neue Ideen erfassen
|
||||||
|
- [[Ideen-Bewertung-Template|⭐ Ideen-Bewertung-Template]] – Ideen bewerten
|
||||||
|
|
||||||
|
### Sessions
|
||||||
|
- [[Session-Summary-Template|📋 Session-Summary-Template]] – Session-Zusammenfassung
|
||||||
|
- [[Agent-Log-Template|🤖 Agent-Log-Template]] – Agent-Aktivitäten loggen
|
||||||
|
|
||||||
|
### Notizen
|
||||||
|
- [[Meeting-Notes-Template|📝 Meeting-Notes-Template]] – Meeting-Protokoll
|
||||||
|
- [[Research-Template|🔬 Research-Template]] – Recherche-Ergebnisse
|
||||||
|
- [[Quick-Capture-Template|⚡ Quick-Capture-Template]] – Schnelle Notiz
|
||||||
|
|
||||||
|
### Wissensdatenbank
|
||||||
|
- [[HowTo-Template|📖 HowTo-Template]] – Schritt-für-Schritt Anleitung
|
||||||
|
- [[Reference-Template|📚 Reference-Template]] – Referenz-Dokumentation
|
||||||
|
- [[Problem-Solution-Template|🔧 Problem-Solution-Template]] – Problemlösung
|
||||||
|
|
||||||
|
---
|
||||||
|
*Tags: #template #meta*
|
||||||
38
01-Wissensdatenbank/Agent-OS/Agent-OS-Wissensdatenbank.md
Normal file
38
01-Wissensdatenbank/Agent-OS/Agent-OS-Wissensdatenbank.md
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
# 🤖 Agent OS Wissensdatenbank
|
||||||
|
|
||||||
|
> Wissen rund um das KPT-LABS Agent OS Framework
|
||||||
|
|
||||||
|
## Themen
|
||||||
|
|
||||||
|
### Architektur
|
||||||
|
- [[KPT-LABS Architektur-Übersicht|Architektur-Übersicht]]
|
||||||
|
- [[Multi-Agent System Design|Multi-Agent System Design]]
|
||||||
|
- [[Session Management Patterns|Session Management Patterns]]
|
||||||
|
|
||||||
|
### Token-Optimierung
|
||||||
|
- [[Token Sparstrategien|Token Sparstrategien]]
|
||||||
|
- [[Context Window Management|Context Window Management]]
|
||||||
|
- [[Auto-Session-Save Pattern|Auto-Session-Save Pattern]]
|
||||||
|
|
||||||
|
### Fallback & Reliability
|
||||||
|
- [[3-Tier Fallback Strategie|3-Tier Fallback Strategie]]
|
||||||
|
- [[API Key Rotation Pattern|API Key Rotation Pattern]]
|
||||||
|
- [[Retry & Backoff Patterns|Retry & Backoff Patterns]]
|
||||||
|
|
||||||
|
### Provider & Modelle
|
||||||
|
- [[Provider Übersicht|Provider Übersicht]]
|
||||||
|
- [[Model Pricing Referenz|Model Pricing Referenz]]
|
||||||
|
- [[RPM/TPM Limits|RPM/TPM Limits]]
|
||||||
|
|
||||||
|
### Prompt Engineering
|
||||||
|
- [[Prompt Templates|Prompt Templates]]
|
||||||
|
- [[Context Injection Patterns|Context Injection Patterns]]
|
||||||
|
- [[Output Formatting|Output Formatting]]
|
||||||
|
|
||||||
|
## 🔗 Verbindungen
|
||||||
|
- [[Agent-Teams Konfiguration|Agent-Teams Konfiguration]]
|
||||||
|
- [[Scheduled Tasks System|Scheduled Tasks System]]
|
||||||
|
- [[02-Projekte/KPT-LABS|KPT-LABS Projekt]]
|
||||||
|
|
||||||
|
---
|
||||||
|
*Tags: #agent-os #kpt-labs #wissensdatenbank*
|
||||||
65
01-Wissensdatenbank/Wissensdatenbank-Übersicht.md
Normal file
65
01-Wissensdatenbank/Wissensdatenbank-Übersicht.md
Normal file
@ -0,0 +1,65 @@
|
|||||||
|
# 📚 Wissensdatenbank Übersicht
|
||||||
|
|
||||||
|
> Zentrale Wissenssammlung – strukturiert nach Domänen
|
||||||
|
|
||||||
|
## Domänen
|
||||||
|
|
||||||
|
### 🤖 [[Agent-OS-Wissensdatenbank|Agent-OS]]
|
||||||
|
- KPT-LABS Framework Architektur
|
||||||
|
- AI Agent Patterns & Best Practices
|
||||||
|
- Multi-Agent Orchestration
|
||||||
|
- Token Management & Optimierung
|
||||||
|
- Fallback-Strategien & Key-Rotation
|
||||||
|
|
||||||
|
### 🛠️ [[DevOps-Wissensdatenbank|DevOps]]
|
||||||
|
- Docker & Container-Orchestrierung
|
||||||
|
- CI/CD Pipelines
|
||||||
|
- Infrastructure as Code
|
||||||
|
- Monitoring & Alerting
|
||||||
|
|
||||||
|
### 🧠 [[ML-Ops-Wissensdatenbank|ML-Ops]]
|
||||||
|
- Model Deployment & Serving
|
||||||
|
- LLM Inference Optimization
|
||||||
|
- Quantization (GGUF, GPTQ, AWQ)
|
||||||
|
- HuggingFace Hub Integration
|
||||||
|
- Experiment Tracking (W&B)
|
||||||
|
|
||||||
|
### 🌐 [[Web-Dev-Wissensdatenbank|Web-Dev]]
|
||||||
|
- Next.js & React Patterns
|
||||||
|
- API-Design & Middleware
|
||||||
|
- Authentication & Security
|
||||||
|
- UI/UX Best Practices
|
||||||
|
- Database Design (SQLite, PostgreSQL)
|
||||||
|
|
||||||
|
### 🔒 [[Security-Wissensdatenbank|Security]]
|
||||||
|
- API Key Management
|
||||||
|
- OAuth & Token Flows
|
||||||
|
- Security Best Practices
|
||||||
|
- Vulnerability Patterns
|
||||||
|
|
||||||
|
### 🔧 [[Tools-Wissensdatenbank|Tools]]
|
||||||
|
- Hermes Agent CLI
|
||||||
|
- OpenCode CLI
|
||||||
|
- Development Tooling
|
||||||
|
- Automation Scripts
|
||||||
|
|
||||||
|
## 📌 Neue Einträge
|
||||||
|
|
||||||
|
```dataview
|
||||||
|
TABLE file.ctags as "Tags", file.mtime as "Aktualisiert"
|
||||||
|
FROM "01-Wissensdatenbank"
|
||||||
|
SORT file.mtime DESC
|
||||||
|
LIMIT 10
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🏷️ Tags Übersicht
|
||||||
|
- `#agent-os` – Agent OS Framework Themen
|
||||||
|
- `#devops` – DevOps & Infrastructure
|
||||||
|
- `#ml-ops` – ML Operations & Model Serving
|
||||||
|
- `#web-dev` – Web Development
|
||||||
|
- `#security` – Security Themen
|
||||||
|
- `#tools` – Tools & CLI
|
||||||
|
- `#best-practice` – Best Practices
|
||||||
|
- `#howto` – Schritt-für-Schritt Anleitungen
|
||||||
|
- `#reference` – Referenz-Dokumentation
|
||||||
|
- `#problem-solution` – Problemlösungen
|
||||||
68
02-Projekte/KPT-LABS/KPT-LABS.md
Normal file
68
02-Projekte/KPT-LABS/KPT-LABS.md
Normal file
@ -0,0 +1,68 @@
|
|||||||
|
# 🤖 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*
|
||||||
39
02-Projekte/Projekt-Übersicht.md
Normal file
39
02-Projekte/Projekt-Übersicht.md
Normal file
@ -0,0 +1,39 @@
|
|||||||
|
# 🚀 Projekt-Übersicht
|
||||||
|
|
||||||
|
> Alle aktiven Projekte auf einen Blick
|
||||||
|
|
||||||
|
## Aktive Projekte
|
||||||
|
|
||||||
|
### 🥇 [[KPT-LABS|KPT-LABS Agent OS Framework]]
|
||||||
|
- **Status**: 🟢 Aktiv – In Entwicklung
|
||||||
|
- **Tech**: Next.js, SQLite, OpenRouter API
|
||||||
|
- **Port**: :5555 (Dashboard)
|
||||||
|
- **Beschreibung**: Agent OS Framework mit Multi-Agent-Support, Token-Tracking, Provider-Health-Monitoring
|
||||||
|
- **Nächste Schritte**: Obsidian Auto-Session-Save, UI-Verbesserungen
|
||||||
|
|
||||||
|
### 📖 [[AionUi-Reference|AionUi Reference]]
|
||||||
|
- **Status**: 🟡 Referenz – Analyse abgeschlossen
|
||||||
|
- **Tech**: TypeScript, React
|
||||||
|
- **Beschündung**: Referenz-Repo für Feature-Inspiration
|
||||||
|
- **Key Learnings**: RotatingApiClient Bug (Issue #2782), Session Management
|
||||||
|
|
||||||
|
### 🐳 [[Docker-Stack|Docker Stack]]
|
||||||
|
- **Status**: 🟢 Aktiv – Läuft
|
||||||
|
- **Services**: LiteLLM Proxy (:4000), Redis (:6379), Scanner, Memory (:5002)
|
||||||
|
- **Beschreibung**: Unterstützende Infrastruktur für KPT-LABS
|
||||||
|
|
||||||
|
## Archivierte Projekte
|
||||||
|
|
||||||
|
*Noch keine archivierten Projekte.*
|
||||||
|
|
||||||
|
## 📊 Projekt-Statistiken
|
||||||
|
|
||||||
|
```dataview
|
||||||
|
TABLE status as "Status", tech as "Technologie"
|
||||||
|
FROM "02-Projekte"
|
||||||
|
WHERE status != "Archiviert"
|
||||||
|
SORT status ASC
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
*Tags: #projekt #übersicht #kpt-labs*
|
||||||
43
03-Ideenpool/Ideenpool-Übersicht.md
Normal file
43
03-Ideenpool/Ideenpool-Übersicht.md
Normal file
@ -0,0 +1,43 @@
|
|||||||
|
# 💡 Ideenpool Übersicht
|
||||||
|
|
||||||
|
> Sammlung von Ideen, Konzepten und Zukunftsplänen
|
||||||
|
|
||||||
|
## Struktur
|
||||||
|
|
||||||
|
### 🟢 [[Ideenpool-Aktiv|Aktiv]]
|
||||||
|
- Ideen die aktuell verfolgt werden
|
||||||
|
- Konkrete Umsetzungspläne vorhanden
|
||||||
|
|
||||||
|
### 📦 [[Ideenpool-Archiviert|Archiviert]]
|
||||||
|
- Zurückgestellte Ideen
|
||||||
|
- Vielleicht später umgesetzt
|
||||||
|
|
||||||
|
### 🗃️ [[Ideenpool-Sammlung|Sammlung]]
|
||||||
|
- Rohe Ideen ohne Konzept
|
||||||
|
- Sammellager für spätere Aufarbeitung
|
||||||
|
|
||||||
|
## Kategorien
|
||||||
|
|
||||||
|
| Kategorie | Beschreibung | Count |
|
||||||
|
|-----------|-------------|-------|
|
||||||
|
| 🤖 Agent OS | Agent-Framework Features | 0 |
|
||||||
|
| 🎨 UI/UX | Dashboard & Design | 0 |
|
||||||
|
| 🔧 DevOps | Infrastructure & Deploy | 0 |
|
||||||
|
| 🧠 ML/AI | Modelle & AI Features | 0 |
|
||||||
|
| 🔒 Security | Sicherheit & Auth | 0 |
|
||||||
|
| 📊 Analytics | Monitoring & Stats | 0 |
|
||||||
|
|
||||||
|
## 📌 Neue Ideen
|
||||||
|
|
||||||
|
```dataview
|
||||||
|
TABLE kategorie as "Kategorie", status as "Status", file.mtime as "Erstellt"
|
||||||
|
FROM "03-Ideenpool"
|
||||||
|
SORT file.mtime DESC
|
||||||
|
LIMIT 10
|
||||||
|
```
|
||||||
|
|
||||||
|
## 💡 Schnell-Idee erfassen
|
||||||
|
Nutze das Template: [[00-Meta/Templates/Ideen-Template|Ideen-Template]]
|
||||||
|
|
||||||
|
---
|
||||||
|
*Tags: #ideen #konzepte #zukunft*
|
||||||
38
04-Sessions/Daily/2026-06-19_14-00_telegram.md
Normal file
38
04-Sessions/Daily/2026-06-19_14-00_telegram.md
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
# 📱 Telegram Session: 2026-06-19
|
||||||
|
|
||||||
|
## 📊 Metriken
|
||||||
|
|
||||||
|
| Metrik | Wert |
|
||||||
|
|--------|------|
|
||||||
|
| **Nachrichten** | 1 |
|
||||||
|
| **Geschätzte Tokens** | ~150 |
|
||||||
|
| **Modell** | `openrouter/owl-alpha` |
|
||||||
|
| **Provider** | OpenRouter |
|
||||||
|
|
||||||
|
## 📝 Zusammenfassung
|
||||||
|
|
||||||
|
Erste Telegram-Session mit OWL Agent. Themen:
|
||||||
|
- Obsidian Vault Setup (`E:\OpenCode_Projekte\obsidianVault`)
|
||||||
|
- Auto-Session-Save Integration für Dashboard
|
||||||
|
- API-Key-Rotation ist Hermes-intern automatisch aktiv
|
||||||
|
- Token-Optimierung durch Kontext-Kompression
|
||||||
|
|
||||||
|
## 🔑 Entscheidungen
|
||||||
|
|
||||||
|
- Auto-Save Intervall: 10 Nachrichten
|
||||||
|
- Vault-Pfad: `E:\OpenCode_Projekte\obsidianVault\04-Sessions\Daily\`
|
||||||
|
- Hermes rotiert API-Keys automatisch über Credential Pools
|
||||||
|
- Obsidian dient als Wissensdatenbank + Session-Archiv
|
||||||
|
|
||||||
|
## ⏳ Nächste Schritte
|
||||||
|
|
||||||
|
- [ ] Mehrere Nachrichten senden um Auto-Save zu testen
|
||||||
|
- [ ] Obsidian Vault in der App öffnen und Sessions prüfen
|
||||||
|
- [ ] Dashboard (Port :5555) testen – Obsidian Tab prüfen
|
||||||
|
|
||||||
|
## 🏷️ Tags
|
||||||
|
|
||||||
|
`#session` `#telegram` `#owl` `#kpt-labs`
|
||||||
|
|
||||||
|
---
|
||||||
|
*Auto-generiert vom OWL Agent – Obsidian Sync*
|
||||||
36
04-Sessions/Session-Übersicht.md
Normal file
36
04-Sessions/Session-Übersicht.md
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
# 📋 Session-Übersicht
|
||||||
|
|
||||||
|
> Auto-gespeicherte Agent-Sessions
|
||||||
|
|
||||||
|
## Struktur
|
||||||
|
|
||||||
|
### 📅 [[Daily-Sessions|Daily Sessions]]
|
||||||
|
- Tägliche Session-Zusammenfassungen
|
||||||
|
- Format: `YYYY-MM-DD_agent-name.md`
|
||||||
|
|
||||||
|
### 📊 [[Weekly-Sessions|Weekly Sessions]]
|
||||||
|
- Wöchentliche Zusammenfassungen
|
||||||
|
- Aggregierte Statistiken
|
||||||
|
|
||||||
|
### 🤖 [[Agent-Logs|Agent-Logs]]
|
||||||
|
- Detaillierte Agent-Aktivitäten
|
||||||
|
- Pro Agent separat
|
||||||
|
|
||||||
|
## 📌 Letzte Sessions
|
||||||
|
|
||||||
|
```dataview
|
||||||
|
TABLE file.ctags as "Agent", file.mtime as "Datum"
|
||||||
|
FROM "04-Sessions"
|
||||||
|
SORT file.mtime DESC
|
||||||
|
LIMIT 10
|
||||||
|
```
|
||||||
|
|
||||||
|
## 💡 Auto-Session-Save
|
||||||
|
|
||||||
|
Sessions werden automatisch vom KPT-LABS Dashboard gespeichert:
|
||||||
|
- **Trigger**: Alle N Nachrichten oder manuell
|
||||||
|
- **Format**: Markdown mit YAML-Frontmatter
|
||||||
|
- **Ort**: `04-Sessions/Daily/YYYY-MM-DD_HH-MM_agent-name.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
*Tags: #sessions #auto-save #agent-logs*
|
||||||
17
04-Sessions/Telegram-Sessions.md
Normal file
17
04-Sessions/Telegram-Sessions.md
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
# 📋 Telegram Session-Tracking
|
||||||
|
|
||||||
|
> Auto-Session-Save für Telegram-Chats mit dem OWL Agent
|
||||||
|
|
||||||
|
## Session-Format
|
||||||
|
|
||||||
|
Jede Telegram-Session wird als Markdown-Datei gespeichert:
|
||||||
|
- **Pfad**: `04-Sessions/Daily/YYYY-MM-DD_HH-MM_telegram.md`
|
||||||
|
- **Trigger**: Alle 10 Nachrichten (konfigurierbar)
|
||||||
|
- **Inhalt**: Zusammenfassung, Entscheidungen, TODOs, Token-Statistiken
|
||||||
|
|
||||||
|
## Sessions
|
||||||
|
|
||||||
|
<!-- sessions -->
|
||||||
|
|
||||||
|
---
|
||||||
|
*Letzte Aktualisierung: 2026-06-19*
|
||||||
11
04-Sessions/telegram-session-tracker.json
Normal file
11
04-Sessions/telegram-session-tracker.json
Normal file
@ -0,0 +1,11 @@
|
|||||||
|
{
|
||||||
|
"session_id": "telegram-floki",
|
||||||
|
"message_count": 1,
|
||||||
|
"last_save_at": null,
|
||||||
|
"auto_save_interval": 10,
|
||||||
|
"model": "openrouter/owl-alpha",
|
||||||
|
"provider": "openrouter",
|
||||||
|
"total_tokens_estimated": 150,
|
||||||
|
"created_at": "2026-06-19T14:00:00Z",
|
||||||
|
"last_topics": ["Obsidian Auto-Session-Save", "API Key Rotation", "Token Optimierung"]
|
||||||
|
}
|
||||||
30
05-Dashboard/Dashboard-Übersicht.md
Normal file
30
05-Dashboard/Dashboard-Übersicht.md
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
# 📊 Dashboard Übersicht
|
||||||
|
|
||||||
|
> Status-Reports & Monitoring-Daten vom KPT-LABS Dashboard
|
||||||
|
|
||||||
|
## Inhalte
|
||||||
|
|
||||||
|
### 📈 [[Token-Stats-Übersicht|Token-Statistiken]]
|
||||||
|
- Token-Verbrauch pro Tag/Woche/Monat
|
||||||
|
- Kosten pro Modell/Provider
|
||||||
|
- Budget-Übersicht
|
||||||
|
|
||||||
|
### ❤️ [[Health-Monitor-Übersicht|Health-Monitors]]
|
||||||
|
- Provider-Status (Online/Offline)
|
||||||
|
- Erfolgsraten & Latenz
|
||||||
|
- API-Key-Status
|
||||||
|
|
||||||
|
### 📋 [[Status-Reports|Status-Reports]]
|
||||||
|
- Automatische Status-Reports
|
||||||
|
- Wöchentliche Zusammenfassungen
|
||||||
|
- Incident-Reports
|
||||||
|
|
||||||
|
## Automatische Updates
|
||||||
|
|
||||||
|
Diese Dateien werden vom KPT-LABS Dashboard automatisch aktualisiert:
|
||||||
|
- Token-Stats: Alle 6 Stunden
|
||||||
|
- Health-Monitor: Alle 30 Minuten
|
||||||
|
- Status-Report: Täglich um 08:00
|
||||||
|
|
||||||
|
---
|
||||||
|
*Tags: #dashboard #monitoring #stats*
|
||||||
32
06-Notizen/Notizen-Übersicht.md
Normal file
32
06-Notizen/Notizen-Übersicht.md
Normal file
@ -0,0 +1,32 @@
|
|||||||
|
# 🗒️ Notizen Übersicht
|
||||||
|
|
||||||
|
> Meeting Notes, Research & Quick Captures
|
||||||
|
|
||||||
|
## Bereiche
|
||||||
|
|
||||||
|
### 📝 [[Meeting-Notes-Übersicht|Meeting Notes]]
|
||||||
|
- Team-Meetings
|
||||||
|
- 1-on-1 Gespräche
|
||||||
|
- Entscheidungsprotokolle
|
||||||
|
|
||||||
|
### 🔬 [[Research-Übersicht|Research]]
|
||||||
|
- Technische Recherchen
|
||||||
|
- Tool-Vergleiche
|
||||||
|
- Proof of Concepts
|
||||||
|
|
||||||
|
### ⚡ [[Quick-Captures-Übersicht|Quick Captures]]
|
||||||
|
- Schnelle Gedanken
|
||||||
|
- TODOs
|
||||||
|
- Linksammlungen
|
||||||
|
|
||||||
|
## 📌 Neue Notizen
|
||||||
|
|
||||||
|
```dataview
|
||||||
|
TABLE file.ctags as "Typ", file.mtime as "Aktualisiert"
|
||||||
|
FROM "06-Notizen"
|
||||||
|
SORT file.mtime DESC
|
||||||
|
LIMIT 10
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
*Tags: #notizen #meeting #research*
|
||||||
46
Home.md
Normal file
46
Home.md
Normal file
@ -0,0 +1,46 @@
|
|||||||
|
# 🗂️ KPT-LABS Obsidian Vault
|
||||||
|
|
||||||
|
> Wissensdatenbank & Projekt-Dashboard für das KPT-LABS Agent OS Framework
|
||||||
|
|
||||||
|
## 🧭 Navigation
|
||||||
|
|
||||||
|
### Wissensbereiche
|
||||||
|
- [[01-Wissensdatenbank/Wissensdatenbank-Übersicht|📚 Wissensdatenbank]] – Technisches Wissen, Best Practices, How-Tos
|
||||||
|
- [[02-Projekte/Projekt-Übersicht|🚀 Projekte]] – Alle aktiven Projekte mit Status
|
||||||
|
- [[03-Ideenpool/Ideenpool-Übersicht|💡 Ideenpool]] – Ideen, Konzepte, Zukunftspläne
|
||||||
|
- [[04-Sessions/Session-Übersicht|📋 Sessions]] – Auto-gespeicherte Agent-Sessions
|
||||||
|
- [[05-Dashboard/Dashboard-Übersicht|📊 Dashboard]] – Status-Reports & Monitoring
|
||||||
|
|
||||||
|
### Quick Access
|
||||||
|
- [[00-Meta/Templates/Template-Übersicht|📝 Templates]] – Alle Vault-Templates
|
||||||
|
- [[06-Notizen/Notizen-Übersicht|🗒️ Notizen]] – Meeting Notes, Research, Quick Captures
|
||||||
|
|
||||||
|
## 🏗️ Vault-Struktur
|
||||||
|
|
||||||
|
```
|
||||||
|
obsidianVault/
|
||||||
|
├── 00-Meta/ → Templates, Konfiguration
|
||||||
|
├── 01-Wissensdatenbank/ → Technisches Wissen (Agent-OS, DevOps, ML-Ops, Web-Dev, Security, Tools)
|
||||||
|
├── 02-Projekte/ → Projekt-Dokumentation & Übersichten
|
||||||
|
├── 03-Ideenpool/ → Ideen (Aktiv, Archiviert, Sammlung)
|
||||||
|
├── 04-Sessions/ → Auto-Session-Saves vom Dashboard
|
||||||
|
├── 05-Dashboard/ → Status-Reports, Token-Stats, Health-Monitors
|
||||||
|
└── 06-Notizen/ → Meeting Notes, Research, Quick Captures
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📌 Aktuelle Highlights
|
||||||
|
|
||||||
|
```dataview
|
||||||
|
TABLE file.ctags as "Tags", file.mtime as "Aktualisiert"
|
||||||
|
FROM "02-Projekte"
|
||||||
|
SORT file.mtime DESC
|
||||||
|
LIMIT 5
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🔗 Externe Links
|
||||||
|
- [[KPT-LABS Dashboard|Dashboard → http://localhost:5555]]
|
||||||
|
- [[KPT-LABS GitHub|GitHub → (URL eintragen)]]
|
||||||
|
|
||||||
|
---
|
||||||
|
*Letzte Aktualisierung: {{date}}*
|
||||||
|
*Vault erstellt: 2026-06-19*
|
||||||
515
README.md
Normal file
515
README.md
Normal file
@ -0,0 +1,515 @@
|
|||||||
|
# 🚀 KPT-LABS Agent OS — System Recovery & Onboarding Guide
|
||||||
|
|
||||||
|
> **Letzte Aktualisierung:** 2026-06-19 14:00 | **Version:** 1.0.0
|
||||||
|
> **Vault Hash:** `v1.0-20260619-1400`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 Inhaltsverzeichnis
|
||||||
|
|
||||||
|
1. [System-Übersicht](#-system-übersicht)
|
||||||
|
2. [Schnellstart (5 Minuten)](#-schnellstart-5-minuten)
|
||||||
|
3. [Wichtige Pfade](#-wichtige-pfade)
|
||||||
|
4. [Datenbank-Schema](#-datenbank-schema)
|
||||||
|
5. [API-Keys & Credentials](#-api-keys--credentials)
|
||||||
|
6. [Services & Ports](#-services--ports)
|
||||||
|
7. [Disaster Recovery](#-disaster-recovery)
|
||||||
|
8. [Umzug auf Neuen PC](#-umzug-auf-neuen-pc)
|
||||||
|
9. [Automatische Prozesse](#-automatische-prozesse)
|
||||||
|
10. [Cron-Jobs](#-cron-jobs)
|
||||||
|
11. [Troubleshooting](#-troubleshooting)
|
||||||
|
12. [Kontakt & Support](#-kontakt--support)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔍 System-Übersicht
|
||||||
|
|
||||||
|
Das KPT-LABS Agent OS ist ein **Multi-Agent Dashboard** mit folgenden Kernkomponenten:
|
||||||
|
|
||||||
|
| Komponente | Beschreibung | Port/Ort |
|
||||||
|
|------------|-------------|----------|
|
||||||
|
| **Dashboard** | Next.js Web-UI | `http://localhost:5555` |
|
||||||
|
| **Datenbank** | SQLite (better-sqlite3) | `dashboard/data/kptlabs.db` |
|
||||||
|
| **Obsidian Vault** | Wissensdatenbank | `E:\OpenCode_Projekte\obsidianVault` |
|
||||||
|
| **Hermes Gateway** | Telegram/Discord Bot | `localhost:8642` |
|
||||||
|
| **LiteLLM Proxy** | LLM API Proxy | `localhost:4000` |
|
||||||
|
| **Redis** | Cache/Session Store | `localhost:6379` |
|
||||||
|
| **Memory Service** | Agent Memory | `localhost:5002` |
|
||||||
|
|
||||||
|
### Architektur-Diagramm
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────────┐
|
||||||
|
│ KPT-LABS Agent OS │
|
||||||
|
├─────────────────────────────────────────────────────────────┤
|
||||||
|
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
|
||||||
|
│ │ Dashboard │ │ Hermes │ │ Telegram/Discord │ │
|
||||||
|
│ │ (Next.js) │ │ Gateway │ │ Bots │ │
|
||||||
|
│ │ Port 5555 │ │ Port 8642 │ │ │ │
|
||||||
|
│ └──────┬───────┘ └──────┬──────┘ └──────────┬──────────┘ │
|
||||||
|
│ │ │ │ │
|
||||||
|
│ └─────────────────┼─────────────────────┘ │
|
||||||
|
│ │ │
|
||||||
|
│ ┌──────┴──────┐ │
|
||||||
|
│ │ LLM APIs │ │
|
||||||
|
│ │ (OpenRouter │ │
|
||||||
|
│ │ Anthropic │ │
|
||||||
|
│ │ OpenAI...) │ │
|
||||||
|
│ └─────────────┘ │
|
||||||
|
│ │
|
||||||
|
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
|
||||||
|
│ │ SQLite DB │ │ Obsidian │ │ Docker │ │
|
||||||
|
│ │ (kptlabs) │ │ Vault │ │ (LiteLLM,Redis) │ │
|
||||||
|
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
|
||||||
|
└─────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 Schnellstart (5 Minuten)
|
||||||
|
|
||||||
|
### Voraussetzungen
|
||||||
|
- Node.js 18+ & npm
|
||||||
|
- Git
|
||||||
|
- Docker & Docker Compose
|
||||||
|
- Obsidian (optional, für Vault)
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Repository klonen
|
||||||
|
git clone <REPO_URL> KPT-LABS
|
||||||
|
cd KPT-LABS
|
||||||
|
|
||||||
|
# 2. Dashboard
|
||||||
|
cd dashboard
|
||||||
|
npm install
|
||||||
|
npm run build
|
||||||
|
npm start
|
||||||
|
|
||||||
|
# 3. Docker Services (LiteLLM, Redis)
|
||||||
|
docker-compose up -d
|
||||||
|
|
||||||
|
# 4. Hermes Gateway (optional)
|
||||||
|
hermes setup
|
||||||
|
hermes gateway start
|
||||||
|
|
||||||
|
# 5. Öffne Dashboard
|
||||||
|
open http://localhost:5555
|
||||||
|
```
|
||||||
|
|
||||||
|
### Erste Schritte
|
||||||
|
1. Login: `FK@KPT-LABS` / `admin`
|
||||||
|
2. System → Obsidian Tab → Sync prüfen
|
||||||
|
3. Chat senden → Token-Tracking testen
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📁 Wichtige Pfade
|
||||||
|
|
||||||
|
### Windows (aktuell)
|
||||||
|
```
|
||||||
|
E:\OpenCode_Projekte\KPT-LABS\
|
||||||
|
├── dashboard/ → Next.js Dashboard
|
||||||
|
│ ├── src/
|
||||||
|
│ │ ├── app/api/ → API-Routen
|
||||||
|
│ │ ├── components/ → React-Komponenten
|
||||||
|
│ │ └── lib/ → Bibliotheken
|
||||||
|
│ ├── data/kptlabs.db → SQLite Datenbank
|
||||||
|
│ └── package.json
|
||||||
|
├── hermes-workspace/ → Hermes Frontend
|
||||||
|
├── obsidianVault/ → Wissensdatenbank
|
||||||
|
│ ├── Home.md
|
||||||
|
│ ├── 00-Meta/
|
||||||
|
│ ├── 01-Wissensdatenbank/
|
||||||
|
│ ├── 02-Projekte/
|
||||||
|
│ ├── 03-Ideenpool/
|
||||||
|
│ ├── 04-Sessions/
|
||||||
|
│ ├── 05-Dashboard/
|
||||||
|
│ └── 06-Notizen/
|
||||||
|
└── docker-compose.yml
|
||||||
|
```
|
||||||
|
|
||||||
|
### Linux/Mac (Zielpfade)
|
||||||
|
```
|
||||||
|
~/KPT-LABS/
|
||||||
|
├── dashboard/
|
||||||
|
├── hermes-workspace/
|
||||||
|
└── obsidianVault/
|
||||||
|
```
|
||||||
|
|
||||||
|
### Wichtige Dateien
|
||||||
|
| Datei | Zweck | Backup? |
|
||||||
|
|-------|-------|---------|
|
||||||
|
| `dashboard/data/kptlabs.db` | Hauptdatenbank | ✅ Täglich |
|
||||||
|
| `obsidianVault/` | Wissensdatenbank | ✅ Git |
|
||||||
|
| `dashboard/.env` | API-Keys | ✅ Verschlüsselt |
|
||||||
|
| `~/.hermes/config.yaml` | Hermes Config | ✅ |
|
||||||
|
| `~/.hermes/auth.json` | Credentials | ✅ |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🗄️ Datenbank-Schema
|
||||||
|
|
||||||
|
### Kern-Tabellen
|
||||||
|
```sql
|
||||||
|
-- Benutzer & Sessions
|
||||||
|
users (id, username, password_hash, role)
|
||||||
|
sessions (id, session_key, user_id, agent_id, title)
|
||||||
|
messages (id, session_id, role, content, agent_id, metadata)
|
||||||
|
|
||||||
|
-- API-Keys & Provider
|
||||||
|
api_keys (id, name, key, provider, is_active, preferred_models, priority)
|
||||||
|
provider_health (provider, model, status, avg_latency_ms, success_count, fail_count)
|
||||||
|
|
||||||
|
-- Token-Tracking
|
||||||
|
token_usage (id, session_id, agent_id, provider, model, input_tokens, output_tokens, cost_usd, latency_ms)
|
||||||
|
token_budgets (agent_id, period, token_limit, cost_limit_usd)
|
||||||
|
model_latency (provider, model, latency_ms, status)
|
||||||
|
|
||||||
|
-- Features
|
||||||
|
scheduled_tasks (id, name, agent_id, prompt, cron_expression, is_active)
|
||||||
|
agent_teams (id, name, leader_agent_id, status)
|
||||||
|
team_members (team_id, agent_id, model, role)
|
||||||
|
session_exports (id, session_id, format, file_path)
|
||||||
|
obsidian_sync_log (id, session_id, success, file_path, tokens_saved)
|
||||||
|
agent_state (id, uptime_seconds, total_sessions, total_messages, health_status)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Wichtige Queries
|
||||||
|
```sql
|
||||||
|
-- Aktive Sessions heute
|
||||||
|
SELECT COUNT(*) FROM sessions WHERE date(created_at) = date('now');
|
||||||
|
|
||||||
|
-- Token-Verbrauch letzte 24h
|
||||||
|
SELECT SUM(total_tokens) FROM token_usage WHERE created_at >= datetime('now', '-1 days');
|
||||||
|
|
||||||
|
-- Provider Status
|
||||||
|
SELECT provider, status, avg_latency_ms FROM provider_health;
|
||||||
|
|
||||||
|
-- Offene Tasks
|
||||||
|
SELECT * FROM tasks WHERE status != 'done';
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔑 API-Keys & Credentials
|
||||||
|
|
||||||
|
### Provider-Konfiguration
|
||||||
|
| Provider | API-Key env var | Status |
|
||||||
|
|----------|----------------|--------|
|
||||||
|
| OpenRouter | `OPENROUTER_API_KEY` | ✅ Aktiv |
|
||||||
|
| Anthropic | `ANTHROPIC_API_KEY` | ⬜ Optional |
|
||||||
|
| OpenAI | `OPENAI_API_KEY` | ⬜ Optional |
|
||||||
|
| DeepSeek | `DEEPSEEK_API_KEY` | ⬜ Optional |
|
||||||
|
|
||||||
|
### Hermes Auth
|
||||||
|
```bash
|
||||||
|
# Credentials anzeigen
|
||||||
|
hermes auth list
|
||||||
|
|
||||||
|
# Neuen Key hinzufügen
|
||||||
|
hermes auth add openrouter
|
||||||
|
hermes auth add anthropic
|
||||||
|
|
||||||
|
# Token-Status prüfen
|
||||||
|
hermes status
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sicherheitshinweise
|
||||||
|
- 🔒 **Nie** API-Keys in Git committen
|
||||||
|
- 🔒 `.env` Dateien sind in `.gitignore`
|
||||||
|
- 🔒 `hermes auth.json` ist verschlüsselt
|
||||||
|
- 🔄 Keys regelmäßig rotieren (monatlich)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🌐 Services & Ports
|
||||||
|
|
||||||
|
| Service | Port | Starten | Status |
|
||||||
|
|---------|------|---------|--------|
|
||||||
|
| Dashboard | 5555 | `npm start` (in dashboard/) | 🟢 |
|
||||||
|
| Hermes Gateway | 8642 | `hermes gateway start` | 🟢 |
|
||||||
|
| LiteLLM Proxy | 4000 | `docker-compose up -d` | 🟢 |
|
||||||
|
| Redis | 6379 | `docker-compose up -d` | 🟢 |
|
||||||
|
| Memory Service | 5002 | `docker-compose up -d` | 🟢 |
|
||||||
|
|
||||||
|
### Docker Services
|
||||||
|
```bash
|
||||||
|
# Starten
|
||||||
|
cd KPT-LABS
|
||||||
|
docker-compose up -d
|
||||||
|
|
||||||
|
# Stoppen
|
||||||
|
docker-compose down
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
docker-compose logs -f
|
||||||
|
|
||||||
|
# Status
|
||||||
|
docker-compose ps
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚨 Disaster Recovery
|
||||||
|
|
||||||
|
### Szenario 1: Datenbank-Crash
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Letztes Backup finden
|
||||||
|
ls -la dashboard/data/backups/
|
||||||
|
|
||||||
|
# 2. Backup wiederherstellen
|
||||||
|
cp dashboard/data/backups/kptlabs_<TIMESTAMP>.db dashboard/data/kptlabs.db
|
||||||
|
|
||||||
|
# 3. Dashboard neu starten
|
||||||
|
cd dashboard
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
### Szenario 2: Obsidian Vault beschädigt
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Git Repository wiederherstellen
|
||||||
|
cd obsidianVault
|
||||||
|
git checkout .
|
||||||
|
git pull
|
||||||
|
|
||||||
|
# Falls kein Git: Backup-Ordner nutzen
|
||||||
|
cp -r /path/to/backup/obsidianVault/* obsidianVault/
|
||||||
|
```
|
||||||
|
|
||||||
|
### Szenario 3: Kompletter System-Verlust
|
||||||
|
|
||||||
|
Siehe [Umzug auf Neuen PC](#umzug-auf-neuen-pc) — das ist die komplette Wiederherstellung.
|
||||||
|
|
||||||
|
### Szenario 4: API-Key abgelaufen
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Neuen Key in .env eintragen
|
||||||
|
echo "OPENROUTER_API_KEY=neuer_key" >> dashboard/.env
|
||||||
|
|
||||||
|
# 2. Dashboard neu starten
|
||||||
|
cd dashboard
|
||||||
|
npm run build
|
||||||
|
npm start
|
||||||
|
|
||||||
|
# 3. Testen
|
||||||
|
curl http://localhost:5555/api/system
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 💻 Umzug auf Neuen PC
|
||||||
|
|
||||||
|
### Schritt 1: Auf altem PC exportieren
|
||||||
|
```bash
|
||||||
|
# Obsidian Vault klonen
|
||||||
|
cd obsidianVault
|
||||||
|
git add -A
|
||||||
|
git commit -m "pre-migration backup"
|
||||||
|
git push
|
||||||
|
|
||||||
|
# Datenbank sichern
|
||||||
|
cp dashboard/data/kptlabs.db kptlabs_backup.db
|
||||||
|
|
||||||
|
# Hermes Config sichern
|
||||||
|
cp ~/.hermes/config.yaml hermes_config_backup.yaml
|
||||||
|
cp ~/.hermes/auth.json hermes_auth_backup.json
|
||||||
|
```
|
||||||
|
|
||||||
|
### Schritt 2: Auf neuem PC importieren
|
||||||
|
```bash
|
||||||
|
# 1. Repository klonen
|
||||||
|
git clone <REPO_URL> KPT-LABS
|
||||||
|
cd KPT-LABS
|
||||||
|
|
||||||
|
# 2. Dashboard installieren
|
||||||
|
cd dashboard
|
||||||
|
npm install
|
||||||
|
cp ../kptlabs_backup.db data/kptlabs.db
|
||||||
|
npm run build
|
||||||
|
npm start
|
||||||
|
|
||||||
|
# 3. Obsidian Vault klonen
|
||||||
|
cd ..
|
||||||
|
git clone <OBSIDIAN_GIT_URL> obsidianVault
|
||||||
|
|
||||||
|
# 4. Hermes wiederherstellen
|
||||||
|
mkdir -p ~/.hermes
|
||||||
|
cp hermes_config_backup.yaml ~/.hermes/config.yaml
|
||||||
|
cp hermes_auth_backup.json ~/.hermes/auth.json
|
||||||
|
|
||||||
|
# 5. Docker starten
|
||||||
|
docker-compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
### Schritt 3: Verifizieren
|
||||||
|
```bash
|
||||||
|
# Dashboard öffnen
|
||||||
|
open http://localhost:5555
|
||||||
|
|
||||||
|
# System Status prüfen
|
||||||
|
curl http://localhost:5555/api/system | jq '.status'
|
||||||
|
|
||||||
|
# Obsidian Sync prüfen
|
||||||
|
curl http://localhost:5555/api/obsidian/sync | jq '.vaultStats'
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⏰ Automatische Prozesse
|
||||||
|
|
||||||
|
### Context Compression
|
||||||
|
- **Wann**: Bei 70% Token-Limit
|
||||||
|
- **Was**: Alte Nachrichten werden zusammengefasst
|
||||||
|
- **Config**: `app_settings.context_compression`
|
||||||
|
|
||||||
|
### Auto-Session-Save
|
||||||
|
- **Wann**: Alle 5 Nachrichten
|
||||||
|
- **Was**: Markdown-Datei in Obsidian Vault
|
||||||
|
- **Ort**: `04-Sessions/Daily/YYYY-MM-DD_agent.md`
|
||||||
|
|
||||||
|
### Token-Tracking
|
||||||
|
- **Wann**: Jeder API-Request
|
||||||
|
- **Was**: Input/Output Tokens, Kosten, Latenz
|
||||||
|
- **Wo**: `token_usage` Tabelle
|
||||||
|
|
||||||
|
### Provider Health Check
|
||||||
|
- **Wann**: Jeder API-Request
|
||||||
|
- **Was**: Erfolgsrate, Latenz, Cooldown
|
||||||
|
- **Wo**: `provider_health` Tabelle
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📅 Cron-Jobs
|
||||||
|
|
||||||
|
| Job | Zeit | API-Call |
|
||||||
|
|-----|------|----------|
|
||||||
|
| Daily Backup | 03:00 | `POST /api/cron/backup` |
|
||||||
|
| Weekly Report | Montag 09:00 | `POST /api/cron/weekly-report` |
|
||||||
|
| Obsidian Sync Check | Alle 6h | `GET /api/obsidian/sync` |
|
||||||
|
|
||||||
|
### Cron-Jobs verwalten
|
||||||
|
```bash
|
||||||
|
# Liste
|
||||||
|
hermes cron list
|
||||||
|
|
||||||
|
# Erstellen
|
||||||
|
hermes cron create "Name" "Prompt" "Schedule"
|
||||||
|
|
||||||
|
# Manuell ausführen
|
||||||
|
hermes cron run <ID>
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔧 Troubleshooting
|
||||||
|
|
||||||
|
### Dashboard startet nicht
|
||||||
|
```bash
|
||||||
|
# Logs prüfen
|
||||||
|
cd dashboard
|
||||||
|
npm run build 2>&1 | tail -20
|
||||||
|
|
||||||
|
# Port prüfen
|
||||||
|
netstat -ano | findstr :5555
|
||||||
|
|
||||||
|
# Neu starten
|
||||||
|
pkill -f next
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
### Datenbank-Fehler
|
||||||
|
```bash
|
||||||
|
# Prüfen
|
||||||
|
sqlite3 dashboard/data/kptlabs.db "SELECT count(*) FROM sessions;"
|
||||||
|
|
||||||
|
# Reparieren
|
||||||
|
sqlite3 dashboard/data/kptlabs.db ".dump" > backup.sql
|
||||||
|
rm dashboard/data/kptlabs.db
|
||||||
|
sqlite3 dashboard/data/kptlabs.db < backup.sql
|
||||||
|
```
|
||||||
|
|
||||||
|
### Obsidian Sync Fehler
|
||||||
|
```bash
|
||||||
|
# Manuell synchronisieren
|
||||||
|
curl -X POST http://localhost:5555/api/obsidian/sync \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"action":"list-sessions"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
### API-Key Probleme
|
||||||
|
```bash
|
||||||
|
# Testen
|
||||||
|
curl http://localhost:5555/api/system
|
||||||
|
|
||||||
|
# Neustart mit frischem Port
|
||||||
|
pkill -f next && sleep 2 && npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 System-Metriken (Live)
|
||||||
|
|
||||||
|
| Metrik | Aktualisierung | API |
|
||||||
|
|--------|---------------|-----|
|
||||||
|
| Sessions | Echtzeit | `/api/chat/sessions` |
|
||||||
|
| Token Usage | 10s | `/api/system` |
|
||||||
|
| Provider Health | 10s | `/api/system` |
|
||||||
|
| Obsidian Sync | 10s | `/api/obsidian/sync` |
|
||||||
|
| Agent State | 10s | `/api/agent-state` |
|
||||||
|
| Feedback | Echtzeit | `/api/feedback` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📝 Changelog
|
||||||
|
|
||||||
|
### v1.0.0 (2026-06-19)
|
||||||
|
- ✅ Initiale Version
|
||||||
|
- ✅ Dashboard mit KPI Widget
|
||||||
|
- ✅ Context Compression
|
||||||
|
- ✅ Auto-Session-Save zu Obsidian
|
||||||
|
- ✅ Feedback-Loop System
|
||||||
|
- ✅ Agent State Tracking
|
||||||
|
- ✅ Cron-Jobs (Backup, Report, Sync)
|
||||||
|
- ✅ Disaster Recovery Guide
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 👥 Rollen
|
||||||
|
|
||||||
|
| Rolle | Zugriff | Beschreibung |
|
||||||
|
|-------|---------|-------------|
|
||||||
|
| **Admin** | Voll | Alles |
|
||||||
|
| **Agent** | Eingeschränkt | Chat, Tools |
|
||||||
|
| **Viewer** | Read-Only | Dashboard ansehen |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔗 Nützliche Links
|
||||||
|
|
||||||
|
- **Dashboard**: http://localhost:5555
|
||||||
|
- **Hermes Docs**: https://hermes-agent.nousresearch.com/docs
|
||||||
|
- **OpenRouter**: https://openrouter.ai/keys
|
||||||
|
- **Obsidian**: https://obsidian.md
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ Checkliste für neuen Agenten
|
||||||
|
|
||||||
|
- [ ] Diese Datei gelesen
|
||||||
|
- [ ] Dashboard geöffnet und Login getestet
|
||||||
|
- [ ] Obsidian Vault Pfad geprüft
|
||||||
|
- [ ] API-Keys vorhanden (`.env`)
|
||||||
|
- [ ] Docker Services laufend
|
||||||
|
- [ ] Erste Chat-Nachricht gesendet
|
||||||
|
- [ ] Token-Tracking geprüft
|
||||||
|
- [ ] Backup getestet
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Diese Datei wird automatisch aktualisiert. Nicht manuell bearbeiten.*
|
||||||
|
*Generiert von: KPT-LABS Agent OS v1.0.0*
|
||||||
|
*Bei Fragen: Erstelle ein Issue im Repository oder kontaktiere den Admin.*
|
||||||
Loading…
x
Reference in New Issue
Block a user