NeXifyAI — Gesamtarchitektur 2026 (v2.0 — aktualisiert 13.07.2026)

Dokument-ID: NEXIFY-ARCH-2026-002 · Version: 2.0 · Stand: 13.07.2026 Status: Lebendes Dokument — wird durch Auto-Work Loop kontinuierlich aktualisiert

1. System-Übersicht

                         app/admin.nexifyai.cloud (Traefik v3.7.7)
                                  │
                    ┌─────────────┼─────────────┐
                    │             │             │
               Hermes WebUI   Paperclip      9Router
                 :8787         :3100         :20128
                    │             │             │
                    └─────────────┼─────────────┘
                                  │
                    ┌─────────────┼─────────────┐
                    │             │             │
               Hermes CLI    Hermes Gateway  Lead-Pipeline
               (Agent Worker) (:8644/3000)   (:8887)
                    │                       
              ┌─────┴─────┐               
              │  Worker    │               
              │  Agenten   │               
              └───────────┘               
                                  
                    ┌─────────────┐
                    │ agentmemory │
                    │   :3111     │
                    │   :3113     │
                    └─────────────┘

2. Komponenten

2.1 Hermes Agent — Worker & Runtime

• Rolle: Vollausgestatteter KI-Agent (30+ native Tools) — Code, DevOps, Admin
• Ports: WebUI :8787, Gateway :8644 (Telegram/WhatsApp/Discord/Slack/E-Mail/Signal), WhatsApp Bridge :3000
• Modell (optimiert 13.07.): ds/deepseek-v4-pro (Default), ds/deepseek-v4-flash (Fallback)
• Reasoning: high (optimiert von xhigh)
• Delegation: bis 3 Sub-Agenten parallel, max 2 Ebenen tief
• Cron: 22 Jobs (17 LLM-basiert + 5 No-Agent Scripts)
• MCP: agentmemory aktiviert, n8n deaktiviert
• Skills: 70+ Skills, inkl. auto-work-loop, devops, developer, reviewer

2.2 Paperclip — Control Plane

• Rolle: Ticket-System, Agent-Orchestrierung, Routinen, Budgets
• Port: :3100
• Companies: NeXifyAI-Core (aktiv), OpenCarBox (geplant), bookando (geplant)
• Agents: Hermes Engineer, Claude Architect, Hermes Comms, Oracle
• Status: ✅ Läuft — Hermes-Paperclip-Adapter noch nicht installiert

2.3 9Router — LLM-Router

• Rolle: OpenAI-kompatibler Proxy für 67 Modelle, 3-Tier-Fallback
• Port: :20128, Domain: ai-router.nexifyai.cloud
• Modelle (67 verfügbar):
  • 6× DeepSeek: v4-pro (Default), v4-pro-max, v4-pro-none, v4-flash (Fallback), chat, reasoner
  • 4× Claude: fable-5, sonnet-5, opus-4-8, opus-4-7, haiku-4.5
  • 18× GPT/CX: gpt-5.6-sol, gpt-5.5, gpt-5.4, gpt-5.4-mini, codex-spark u.a.
  • 28× GitHub Models: gpt-4o, gpt-4.1, claude-haiku, o1-mini u.a.
  • 2× Anthropic: claude-sonnet-4, claude-opus-4
  • 9× xmtp/Mimo: v2.5-pro, v2.5, v2-pro, v2-omni, TTS u.a.
• Features: RTK-Token-Kompression, Dashboard, usage.db
• Tunnel: Cloudflare Tunnel aktiv (ai-router.nexifyai.cloud)

2.4 agentmemory — Cross-Agent Gedächtnis

• Rolle: Persistenter Wissensspeicher für alle Agenten, Hybrid-Suche, Versionierung
• Ports: :3111 (API/iii), :3112 (WebSocket), :3113 (Viewer)
• MCP: ✅ Aktiviert (seit 13.07.2026)
• Tunnel: Cloudflare Tunnel aktiv (agentmemory.nexifyai.cloud)
• Speicher: ~2650+ Einträge (facts, bugs, workflows, architecture)

2.5 Lead-Pipeline — Webhook für Lead-Erfassung

• Rolle: REST API + Webhook für externe Lead-Erfassung
• Port: :8887 (systemd-managed, lead-pipeline.service)
• Endpoints: GET/POST /api/leads, GET /health, OPTIONS /api/leads
• Data: JSON-Datei (in .gitignore, Backups via backup.sh Step 10.5)
• Integrationen: n8n-Webhook bereit (Workflow-JSON erstellt)

2.6 Monitoring & Observability

• Grafana: :3030 (fixed 13.07., Port-Konflikt WhatsApp-Bridge)
  • Dashboards: nexifyai-system.json, nexifyai-leads.json
• Prometheus: :9090 (v3.13.1)
  • Targets: node, cadvisor, traefik, 11+ blackbox probes
  • Lead-Pipeline: ✅ als Probe-Target hinzugefügt
• cAdvisor: :8080
• Blackbox Exporter: HTTP-Probing aller Services

2.7 Entfernte Komponenten (nicht mehr im System)

| Komponente | Entfernt am | Grund | |-----------|-------------|-------| | n8n | 13.07.2026 | Pascal-Entscheidung (GDOK Kap. 2.5) | | OpenClaw | — | Nie implementiert, Referenzen gelöscht | | LibreChat | — | Durch Hermes WebUI ersetzt | | OpenHands SDK | — | Durch Hermes Terminal-Backends ersetzt |

3. Modell-Routing (Stand 13.07.2026)

Alle Anfragen → 9Router :20128
                    │
        ┌───────────┼───────────┐
        │           │           │
   Tier 1        Tier 2      Tier 3
   Default       Mittel      Fallback
   v4-pro        reasoner    v4-flash
   (günstig)     (hohe       (günstigst)
                 Leistung)

• Default: ds/deepseek-v4-pro (Kostenoptimiert 13.07.)
• Fallback: ds/deepseek-v4-flash (Günstigstes Modell)
• Reasoning: high (reduziert von xhigh, -20% Tokens)
• MOA (Mixture-of-Agents): Verfügbar aber deaktiviert (spart Tokens)

4. Auto-Work Loop (permanent integriert)

Der 8-Phasen-Regelkreis ist seit 13.07.2026 permanent im System verankert:

Phase 1: Wissen laden + IST erfassen
Phase 2: SOLL-Abweichungen (GDOK vs Live)
Phase 3: Queen-Mode Auftrag generieren (9 Felder)
Phase 4: Ausführen (Backup → Code → Deploy)
Phase 5: Verifizieren (L1/L2/L3 — 3-Stufen)
Phase 6: Speichern (Git + Memory + agentmemory)
Phase 7: Nächsten Auftrag generieren
Phase 8: Wiederholen → Phase 1

• Skill: nexifyai-auto-work-loop (permanent auto_load)
• Cron: 2× täglich (07:00/19:00) als Queen-Mode-Orchestrator
• AGENTS.md: Enthält vollständige Direktive
• Abbruch: Nur bei "Stoppe Auto-Work" oder wenn ALLE Gaps geschlossen

5. Auto-Work Loop Dauer-Cron

| Job | Takt | Typ | Status | |-----|------|-----|--------| | Orchestrator (Queen-Mode) | 2× tgl (07/19) | Skills: 4 | ✅ Aktiv | | Oracle Audit (Soll-Ist) | tägl. 06:00 | No-Agent | ✅ Skript | | Reliability Sweep | alle 15min | No-Agent | ✅ Skript | | mem0 Consistency | tägl. 03:00 | No-Agent | ✅ Skript | | 9Router Cost | wöch. Mo 05:00 | No-Agent | ✅ Skript | | Paperclip Backup | wöch. So 02:00 | No-Agent | ✅ Skript | | System Health Check | 30min | LLM | ✅ | | GitHub PR Watch | 15min | LLM | ✅ | | Auto Code Reviewer | 15min | LLM | ✅ | | Morning Briefing | 08:00 tgl | LLM | ✅ | | + 12 weitere | div. | div. | ✅ |

6. KPIs & Metriken

| Metrik | Aktuell | Ziel | |--------|---------|------| | Docker Container | 28 | Stabil | | Systemd Services | 8/8 aktiv | 8/8 | | Cron Jobs | 22 aktiv | Alle ✅ | | Validation | 30/30 | 30/30 | | 9Router Modelle | 67 | Nutzbar | | Endpunkt-Health | 10/10 | 10/10 ✅ | | Git Repos | 5 clean | Clean | | agentmemory Einträge | ~2650 | Wächst | | Auto-Work Integration | ✅ | Permanent |

7. Governance Agent

• Rolle: Automatischer Policy-Wächter (VOLLBETRIEB §4)
• Cron: Staendlich (no-agent, script-basiert)
• Gates: 7 (BRAIN_FIRST, DOCS_FIRST, Shared State, System State, Security, Monitoring, LLM)
• Policy-Basis: GOVERNANCE.md (139 Docs) + VOLLBETRIEB.md
• Status: ✅ Aktiv seit 13.07.2026