Zum Inhalt

Agent Runtime

Stand: 2026-05-25

Ziel

Diese Struktur beschreibt die produktive Weiterentwicklung der bestehenden Lanstyle AI-Plattform zu einer lokalen Infrastruktur-Agent-Runtime. Sie ersetzt keine vorhandenen Dienste, sondern ordnet OpenCode, Ollama, Gitea, MkDocs, NetBox, Vaultwarden, n8n und MCPs zu einem wartbaren Betriebsmodell.

OpenCode bleibt das bevorzugte Frontend. Open WebUI bleibt fuer Chat, Team-Nutzung, Knowledge und einzelne Tools erhalten. Automationen laufen nachvollziehbar ueber Git, n8n, MCPs und kontrollierte Approval-Flows.

Prinzipien

  • Bestehende Dienste erweitern statt ersetzen.
  • Gitea/MkDocs ist die versionierte Wissensquelle.
  • NetBox ist die fuehrende technische Infrastrukturquelle.
  • Vaultwarden ist die Secret-Quelle.
  • Keine produktiven Schreibaktionen ohne Plan, Backup, Rollback und Approval.
  • Read-only Discovery darf automatisiert laufen.
  • Toolserver werden nach Risiko klassifiziert.
  • Jeder Agent-Run bekommt eine nachvollziehbare Run-ID.
  • Jede dauerhafte Aenderung landet in Git oder NetBox, nicht nur im Chatverlauf.

Komponenten

Komponente Rolle
OpenCode Primaeres Agent-Frontend fuer Infrastrukturarbeit
Ollama Lokaler Modell-Provider auf GB10/DGX Spark
LiteLLM Aktiver Modellrouter fuer einheitliche Namen, Fallbacks und Logging
MCPHub Aktive Registry/Proxy-Schicht fuer MCP-Server
FastMCP Standard fuer eigene interne MCPs
Gitea Repositories fuer Doku, Prompts, Runbooks, Skripte und Agent-Konfiguration
MkDocs Material Menschenlesbares Frontend fuer Gitea-Dokumentation
NetBox Produktive Source of Truth fuer IPAM/DCIM
Vaultwarden Secrets und Tokens
n8n Workflow-Orchestrierung, Scheduling, Notifications
Qdrant Aktiver Knowledge-Index fuer bereinigte Markdown-/Runbook-Daten
PostgreSQL Aktive Datenbankbasis fuer LiteLLM, spaeter Run-/Task-/Approval-Speicher

Aktueller Ausbau

Stand 2026-05-25:

  • Healthchecks laufen ueber n8n und systemd.
  • Secretfreie NPM-/NetBox-/Proxmox-Snapshots liegen in agent-runtime/exports/.
  • Interne read-only MCP-Basis liegt unter agent-runtime/mcp/lanstyle-infra-mcp.
  • OpenCode-MCP-Beispiel liegt unter agent-runtime/configs/opencode-mcp.example.json.
  • Dedizierter Agent-Runtime-LXC 259 laeuft VLAN70-only unter 10.222.70.20.
  • LiteLLM, Qdrant, PostgreSQL, Redis und MCPHub laufen in /opt/agent-runtime.