Dokumentation

Zenpower Technischer Überblick

Dieses Portal liefert operator-orientierte Leitfäden, ohne privaten Code oder personenbezogene Daten offenzulegen. Jede Sektion verweist auf laufend gepflegte Dokumentation in der Zenpower Knowledge Base.

Letzter Index-Build vor 1 Stunde · 24.01.2026, 09:46.

Plattformstatus Öffentlicher Footprint Community-Feed
Schnappschuss

Dokumentations-Feed auf einen Blick

Der Docs-Index wird vor Deployments automatisiert neu erzeugt. Die untenstehenden Zahlen enthalten nur freigegebene Inhalte nach Keyword-Filter.

Kategorien

15

Einträge

890

Index-Build

vor 1 Stunde · 24.01.2026, 09:46

Ecosystem

Live Platform Metrics

Real-time indicators from the Zenpower infrastructure. Version 0.8.8, January 2026.

Containers

40

Subdomains

29

API Endpoints

961+

MCP Tools

389

AI Providers

4

Tests Passing

3,300+

Quick Links

Popular Resources

Jump straight to the most-used tools and documentation.

🔧 MCP Tool Explorer Browse 145+ AI tools ▶ MCP Playground Interactive tool testing 📊 System Status Live health dashboard 🗺 Roadmap 2026 Development timeline 💻 Console ZENPOWER 2048 MUD 🎮 ZenTropy On-chain gaming
Architektur

High-Level-Systemkarte

Zenpower ist als modulare Plattform aufgebaut: ein gehärteter Operations-Kern, Sandbox-Umgebungen für Integrationen und eine Dokumentations-/MCP-Schicht zur Unterstützung von Operatoren. Subdomains spiegeln diese Verantwortlichkeiten wider. 

┌─────────────────────────────────────────────────────────────────────────────┐
│                              USER LAYER                                      │
│   Browser ────── Mobile ────── CLI (Claude Code) ────── Discord Bot          │
└───────────────────────────────────┬─────────────────────────────────────────┘
                                    │
┌───────────────────────────────────▼─────────────────────────────────────────┐
│                           GATEWAY LAYER                                      │
│   ┌─────────────┐    ┌───────────────┐    ┌─────────────┐                   │
│   │   Traefik   │───▶│  Forward-Auth │───▶│ Rate Limit  │  29 Subdomains   │
│   │  (TLS/ACME) │    │  (SIWE/Email) │    │  (50r/s)    │                   │
│   └─────────────┘    └───────────────┘    └─────────────┘                   │
└───────────────────────────────────┬─────────────────────────────────────────┘
                                    │
┌───────────────────────────────────▼─────────────────────────────────────────┐
│                         APPLICATION LAYER                                    │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐          │
│  │ Landing  │ │   API    │ │  Admin   │ │   MCP    │ │ Console  │          │
│  │ (Astro)  │ │(FastAPI) │ │(FastAPI) │ │ Gateway  │ │ (WebGL)  │          │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘          │
│        856 pages    961 endpoints    25 dashboards  145 tools              │
└───────────────────────────────────┬─────────────────────────────────────────┘
                                    │
┌───────────────────────────────────▼─────────────────────────────────────────┐
│                            DATA LAYER                                        │
│   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐                  │
│   │  PostgreSQL  │    │    Redis     │    │  Prometheus  │                  │
│   │  (5 schemas) │    │ (cache/jobs) │    │  (metrics)   │                  │
│   └──────────────┘    └──────────────┘    └──────────────┘                  │
└───────────────────────────────────┬─────────────────────────────────────────┘
                                    │
┌───────────────────────────────────▼─────────────────────────────────────────┐
│                         EXTERNAL INTEGRATIONS                                │
│   ┌────────────────────┐    ┌────────────────────┐    ┌──────────────────┐  │
│   │     Blockchain     │    │    AI Providers    │    │      Other       │  │
│   │  Arbitrum, Base    │    │ Gemini, Anthropic  │    │  Alchemy, ENS    │  │
│   │  Ethereum Mainnet  │    │  OpenAI, xAI Grok  │    │  IPFS, Discord   │  │
│   └────────────────────┘    └────────────────────┘    └──────────────────┘  │
└─────────────────────────────────────────────────────────────────────────────┘

Kernflächen

  • zenpower.at — Landing + wallet onboarding (SIWE)
  • api.zenpower.at — FastAPI with 961 endpoints, Prometheus metrics
  • admin.zenpower.at — 25 dashboards, RBAC, killswitches
  • status.zenpower.at — Health snapshots, ecosystem tests
  • account.zenpower.at — Wallet dashboard, companion, activity

Gaming & Interactive

  • console.zenpower.at — ZENPOWER 2048, 16 emulators, ZENBASIC
  • zentropy.zenpower.at — On-chain game, 754 tests passing
  • gallery.zenpower.at — NFT Gallery with Alchemy integration
  • art.zenpower.at — Art Muse, Archillect-style curation
  • explore.zenpower.at — Mindset Explorer (mental wellness)

AI & Intelligence

  • mcp.zenpower.at — 145 tools, 47 workers, RAG search
  • AI Gateway — Gemini, Anthropic, OpenAI, xAI Grok
  • Discord Bot — AI-powered knowledge queries
  • Companions — 5 personalities, bond levels, memory
  • Sanctuary — Crisis support, F9 trigger

Blockchain & Web3

  • SIWE — Sign-in with Ethereum, ENS resolution
  • Smart Contracts — ZENCOIN, TheForge, Governor (testnet)
  • NFT Scanner — Alchemy-powered, 66x faster
  • Multi-chain — Arbitrum Sepolia + Base Sepolia

Infrastructure

  • 40 containers, 99.9% uptime, systemd orchestration
  • Traefik reverse proxy, ACME TLS on 29 subdomains
  • PostgreSQL, Redis, Prometheus, Grafana, Loki
  • Boot orchestration (fixperms, containers, healthcheck)

Content & Social

  • social.zenpower.at — Community feed, dispatches
  • AI Influencer — Multi-platform posting (X, Farcaster, Bluesky)
  • Knowledge Base — 4 domains (zen, bitcoin, cypherpunk, demoscene)
  • odoo.zenpower.at — ERP for creator economy
MCP Gateway

Model Context Protocol

The MCP Gateway provides AI agents with structured access to Zenpower systems. 145 tools across 47 workers enable intelligent automation, semantic search, and ecosystem orchestration.

Core Workers

  • docs — Full-text documentation search
  • rag — Semantic search (118MB, 11K chunks)
  • brain — Knowledge intelligence (20+ tools)
  • gemini — Embeddings + AI generation
  • claude — Anthropic AI integration

Domain Workers

  • blockchain — Wallet, NFT, ENS (11 tools)
  • economy — Currency, staking, mining (17 tools)
  • defi — Bridge, pools, MEV protection (11 tools)
  • zentropy — Quests, games, mining (9 tools)
  • entities — Collaborators, memorials (6 tools)

Integration

  • Endpoint: http://127.0.0.1:6290/mcp
  • Public: https://mcp.zenpower.at/mcp
  • Claude Code: Add to ~/.claude.json
  • Health: /health returns worker status
Knowledge BRAIN

"I am the memory that never forgets"

The BRAIN is Zenpower's military-grade unified intelligence system. It provides conversation memory, decision tracking, advanced hybrid search, and cross-modal knowledge linking with full audit trails.

4-Tier Memory Hierarchy

  • Working — Current conversation (<128K tokens), instant access
  • Episodic — Recent sessions (7 days), fast retrieval
  • Semantic — Knowledge graph (entities, relations, facts)
  • Archival — Compressed history (90+ days), slow retrieval

v2.0 Capabilities

  • HNSW vector indexing (15x faster search)
  • Adaptive query routing (50% compute reduction)
  • HyDE — Hypothetical Document Embeddings
  • ColBERT late-interaction reranking (+20% accuracy)
  • MemGPT-style infinite context management

v3.0 Multi-Provider

  • 6 AI providers with intelligent routing
  • Kimi K2 — 2M token long-context ingestion
  • Mistral — EU-compliant GDPR processing
  • Cost optimization with free tier rotation
  • Provider health monitoring + failover

Cross-Modal Links

  • Docs ↔ Code — Implementation references
  • Code ↔ Tests — Test coverage tracking
  • Conversations ↔ Decisions — Rationale chains
  • Entities ↔ All — Knowledge graph nodes

Decision Tracking

  • Architecture, implementation, config decisions
  • Policy, feature, bugfix categorization
  • Status: active, superseded, reverted
  • Full rationale with temporal versioning

API Endpoints

  • POST /brain/search — Hybrid search
  • POST /brain/ask — RAG-augmented Q&A
  • POST /brain/ingest — Knowledge ingestion
  • GET /brain/decisions — Decision history
RAG & RAPTOR

Retrieval-Augmented Generation

Advanced retrieval architecture combining semantic search, RAPTOR hierarchical trees, and GraphRAG community detection. 11,159 indexed chunks across docs, code, and tests enable precise knowledge retrieval.

RAG Indexes (118MB)

  • docs — 3,649 chunks (39MB) — Documentation
  • code — 5,000 chunks (53MB) — Source code
  • tests — 2,510 chunks (26MB) — Test functions
  • JSON backend with optional UKS (Unified Knowledge Store)

5 Retrieval Strategies

  • FULLTEXT — Keyword matching, fastest
  • SEMANTIC — Embedding similarity search
  • GRAPH — Knowledge graph traversal
  • RAPTOR — Hierarchical tree search
  • HYDE — Hypothetical document expansion

Adaptive Query Routing

  • SIMPLE — Direct lookup, fulltext only
  • FACTUAL — Semantic + reranking
  • EXPLORATORY — Graph + community search
  • COMPLEX — All strategies + RRF fusion

RAPTOR Trees

  • Recursive Abstractive Processing (ICLR 2024)
  • 5-level hierarchical summarization
  • Clustering-based node construction
  • +20% accuracy on complex queries

GraphRAG Communities

  • LLM-based entity/relation extraction
  • Leiden algorithm community detection
  • Hierarchical community summaries
  • Based on Microsoft GraphRAG paper

Performance Targets

  • <50ms p95 latency (simple queries)
  • 100+ QPS throughput
  • L1/L2 caching (Redis-backed)
  • 6-7% F1 improvement via routing
MUD Engine

Planet Zen

A text-based multiplayer world with 40 rooms, real-time WebSocket communication, combat system, and AI-powered creature dialogue. Quest rewards bridge to the ZenTropy economy.

World Features

  • 40 interconnected rooms across zones
  • 9 creature types (Tier 0-3 + Boss)
  • 53 item templates (weapons, armor, consumables)
  • 24 spawn points with auto-respawn

Systems

  • Combat — fight, attack, flee, rest, talk
  • Crafting — 20 universal recipes (Tier 0-3)
  • Quests — 10 quests with ZEN rewards
  • Item Bridge — MUD to ZenTropy transfers

API

  • POST /mud/move — Navigation
  • POST /mud/action — Combat/interact
  • WS /mud/ws/{user_id} — Real-time
  • GET /mud/spawns/status — Spawn system
Operations

Betriebsprinzipien

Jedes Deployment folgt dokumentierten Guardrails: unveränderliche Infrastruktur, TLS-Erzwingung, Zugriffsprotokollierung und AI/Mensch-Kollaboration, festgehalten im Status-Ledger.

  1. Infrastructure: Docker Compose orchestrated by systemd (zenpower.service) with rootless workers and aggressive seccomp defaults.
  2. Secrets: Environment values sourced from encrypted vault material; no secrets in the public repo.
  3. Certificates: Traefik acquires ACME certificates for each subdomain; ops/checks.sh fails if issuers drift.
  4. Observability: make health-matrix erfasst Admin-/API-/Worker-Health sowie Backup-Timer in zenpower/docs/en/status/health_matrix.json.
  5. Audit: Deployment-Historie landet unter docs/en/status/deploy_log.md; die Landingpage hebt diese Erfolge hervor.
Dokumentenkarte

Kuratiert & öffentlich sicher

Die folgenden Listen referenzieren Dokumentationsfamilien, die extern geteilt werden können. Private Inhalte verbleiben im Git-Repository und erscheinen hier nicht.

Mehr Einblick nötig? Beantrage temporären GitHub-Zugang oder nutze die interne Knowledge Base via ZenControl. Jeder Zugriff wird protokolliert und geprüft.

Erkunde die Zenpower-Flächen

Jedes Modul teilt die Synthwave-Ruhe – wähle eine Fläche und entdecke mehr.

CORE

Dok-Portal

Navigierbares Wissen mit manifest-gesteuerten Deep Links.

Docs erkunden

CORE

Kontoeinstellungen

Verwalte dein Wallet-Profil, Einstellungen und verknüpfte Dienste.

Konto verwalten