Meleki
72347ed2f5
ARCHITECTURE.md: - Kapitel 18 umbenannt: Multi-Agent Review-System → Multi-Agent System (Review + Finalizer) - Finalizer-Agent komplett dokumentiert (Konfiguration, Backend-Flow, SSE-Events, Frontend) - RunAgentChat() als generische Methode für Review/Finalizer dokumentiert - Neues Kapitel Web-Search (Backend, Streaming pauseStreamBubble, History, Shared-Page) - Sessions-Tabelle: finalizer_agent_id, Message-Typ: web_search_result - Entity-Relationship: Finalizer-Agent Beziehung - Chat-Pipeline: Phase 4c (Finalizer) ARCHITECTURE_QUICK.md: - Multi-Agent System Sektion erweitert (Finalizer-Flow, SSE-Events, Frontend-Rendering) - Web-Search Sources Sektion (DB, History, Shared-Page, Streaming) - Tabellen + Message-Typen aktualisiert README.md: - Finalizer-Agent und Web-Search als Features
156 lines
5.7 KiB
Markdown
156 lines
5.7 KiB
Markdown
|
||
|
||
# // gott
|
||
|
||
Self-hosted AI-Coding-Agent auf Basis der Anthropic Claude API. Stellt eine Web-UI bereit, über die man in Sessions mit konfigurierbaren Agenten chatten kann. Die Agenten haben Tool-Zugriff (Dateien lesen/schreiben/bearbeiten, Shell-Befehle ausführen, Suchen, Todos, Memory) auf ein definiertes Workspace-Verzeichnis.
|
||
|
||
---
|
||
|
||
## Features
|
||
|
||
- **Multi-Agent-System** – Mehrere Agenten mit eigenen Identitäten, Persönlichkeiten und Tool-Konfigurationen
|
||
- **Multi-Agent Review** – Optionaler Review-Agent pro Session, der die Arbeit des Worker-Agents prüft und Feedback gibt
|
||
- **Finalizer-Agent** – Optionaler Agent, der nach dem Review abschließende Arbeiten durchführt (z.B. Git-Commit, Deployment)
|
||
- **Web-Search** – Integrierte Web-Suche mit Quellenangaben (URLs + Titel) in Chat und geteilten Nachrichten
|
||
- **12 Tools** – `read_file`, `write_file`, `edit_file`, `list_files`, `delete_file`, `execute`, `glob`, `grep`, `todo_write`, `memory_read`, `memory_write`, `memory_list`
|
||
- **Streaming** – Echtzeit-Antworten via Server-Sent Events (SSE)
|
||
- **Stop-Button** – Laufende Requests zuverlässig abbrechen (inkl. laufender Shell-Befehle)
|
||
- **Skill-System** – Wiederverwendbare Prompt-Bausteine, zuordenbar pro Agent
|
||
- **Memory** – Persistentes Gedächtnis pro Agent (Dateisystem-basiert)
|
||
- **Workspace-Browser** – Integrierter Datei-Explorer mit Editor
|
||
- **Telegram-Integration** – Agents über Telegram ansprechen
|
||
- **Cronjobs** – Zeitgesteuerte Prompts mit Cron-Expressions
|
||
- **Bildgenerierung** – Krea AI Integration für Bildgenerierung
|
||
- **Nachrichten teilen** – Einzelne Nachrichten per öffentlichem Link teilen
|
||
- **Archivierung** – Chat-Verläufe archivieren und durchsuchen
|
||
- **Benutzerverwaltung** – Multi-User mit Admin-Rollen, Impersonate, Login-Links
|
||
- **Servereinstellungen** – Admin-UI für `appsettings.Production.json`
|
||
- **Desktop-Client** – WPF + WebView2 Windows-App
|
||
- **Dark Theme** – CSS-Variables basiertes Theming
|
||
|
||
## Tech-Stack
|
||
|
||
| Bereich | Technologie |
|
||
|---------|-------------|
|
||
| **Backend** | .NET 10 Minimal API, C# |
|
||
| **Datenbank** | SQLite + Dapper |
|
||
| **AI** | Anthropic Claude API (SSE Streaming) |
|
||
| **Frontend** | Vanilla JS SPA (kein Framework), CSS Variables |
|
||
| **Mathe** | KaTeX (LaTeX-Rendering) |
|
||
| **Bilder** | SixLabors.ImageSharp |
|
||
| **Cron** | Cronos |
|
||
| **Desktop** | WPF + WebView2 (optional) |
|
||
|
||
---
|
||
|
||
## Voraussetzungen
|
||
|
||
- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
|
||
- Anthropic API Key ([console.anthropic.com](https://console.anthropic.com/))
|
||
- Linux/macOS/Windows (Produktiv: Linux empfohlen)
|
||
|
||
## Konfiguration
|
||
|
||
Beim ersten Start wird `appsettings.json` mit Standardwerten verwendet. Für eigene Einstellungen eine `appsettings.Production.json` im `publish/`-Verzeichnis anlegen (oder über die Admin-UI verwalten):
|
||
|
||
```json
|
||
{
|
||
"Port": 19000,
|
||
"AnthropicToken": "sk-ant-...",
|
||
"MaxIterations": 100,
|
||
"PayloadLogging": false,
|
||
"PayloadLoggingGzip": false,
|
||
"KreaToken": "",
|
||
"KreaApiKey": ""
|
||
}
|
||
```
|
||
|
||
| Setting | Beschreibung | Default |
|
||
|---------|-------------|---------|
|
||
| `Port` | Server-Port (erfordert Neustart) | `19000` |
|
||
| `AnthropicToken` | Anthropic API Key (**erforderlich**) | – |
|
||
| `MaxIterations` | Max Tool-Loop Iterationen pro Chat | `100` |
|
||
| `PayloadLogging` | API-Payloads in Konsole loggen | `false` |
|
||
| `PayloadLoggingGzip` | Payload-Logs als .gz komprimieren | `false` |
|
||
| `KreaToken` | Krea AI API Token (optional) | – |
|
||
| `KreaApiKey` | API-Key für Krea-Endpoints ohne User-Auth (optional) | – |
|
||
|
||
> **Hinweis:** Die `appsettings.Production.json` wird **nicht** beim `dotnet publish` mitkopiert. Sie lebt ausschließlich im `publish/`-Verzeichnis und kann über die Admin-UI (`#/server-settings`) verwaltet werden.
|
||
|
||
## Starten
|
||
|
||
```bash
|
||
dotnet run
|
||
```
|
||
|
||
Die Web-UI ist dann unter `http://localhost:19000` erreichbar.
|
||
|
||
Beim ersten Start wird automatisch ein Admin-Account erstellt:
|
||
- Benutzername: `admin`
|
||
- Passwort: `admin`
|
||
|
||
## Deployment (Linux)
|
||
|
||
Empfohlen als systemd-Service hinter einem Reverse Proxy (Nginx, Caddy):
|
||
|
||
```bash
|
||
# deploy.sh (Beispiel)
|
||
#!/bin/bash
|
||
set -e
|
||
cd /app/gott
|
||
systemctl stop gott
|
||
dotnet publish -c Release -o publish
|
||
systemctl start gott
|
||
```
|
||
|
||
Beispiel systemd-Unit (`/etc/systemd/system/gott.service`):
|
||
|
||
```ini
|
||
[Unit]
|
||
Description=Gott
|
||
After=network.target
|
||
|
||
[Service]
|
||
Type=exec
|
||
WorkingDirectory=/app/gott
|
||
ExecStart=/app/gott/publish/gott
|
||
Restart=on-failure
|
||
RestartSec=5
|
||
|
||
[Install]
|
||
WantedBy=multi-user.target
|
||
```
|
||
|
||
---
|
||
|
||
## Projektstruktur
|
||
|
||
```
|
||
gott/
|
||
├── Program.cs # Startup, DI, Middleware, Routing
|
||
├── appsettings.json # Standard-Konfiguration
|
||
├── Models/ # Records (reine Daten)
|
||
├── Services/ # Business-Logic (Singletons)
|
||
├── Endpoints/ # HTTP API (Minimal API)
|
||
├── Middleware/ # Auth-Middleware
|
||
├── Templates/ # Vorlagen (IDENTITY.md, SOUL.md, USER.md)
|
||
├── wwwroot/ # Frontend (Vanilla JS SPA)
|
||
│ ├── js/ # App, Router, API, Chat, UI-Helpers, Pages
|
||
│ └── css/ # Styles (theme.css = CSS Variables)
|
||
├── WindowsApp/ # WPF + WebView2 Desktop Client
|
||
└── publish/ # Build-Output + Laufzeit-Daten
|
||
└── data/
|
||
├── gott.db # SQLite Datenbank
|
||
├── agents/{id}/ # Memory-Dateien pro Agent
|
||
├── skills/{slug}/ # Skill-Dateien
|
||
└── images/ # Krea-generierte Bilder
|
||
```
|
||
|
||
Ausführliche Dokumentation: [ARCHITECTURE.md](ARCHITECTURE.md) · Kurzreferenz: [ARCHITECTURE_QUICK.md](ARCHITECTURE_QUICK.md)
|
||
|
||
---
|
||
|
||
## Lizenz
|
||
|
||
Proprietär – Alle Rechte vorbehalten.
|