Documentation

Zenpower Technical Overview

This portal provides operator-facing guidance without exposing private code or personal data. Every section links back to living documentation inside the Zenpower knowledge base.

Last index build 7 hours ago · 24 Jan 2026, 09:46.

Platform Status Public Footprint Community Feed
Snapshot

Documentation feed at a glance

The docs index is rebuilt by tooling before deployments. Counts below only include public-safe material after keyword filtering.

Categories

15

Entries

890

Index build

7 hours ago · 24 Jan 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
Architecture

High-level system map

Zenpower is organised as a modular platform: a hardened operations core, sandbox environments for integration work, and a documentation/MCP layer for operator enablement. Subdomains mirror these responsibilities. 

┌─────────────────────────────────────────────────────────────────────────────┐
│                              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   │  │
│   └────────────────────┘    └────────────────────┘    └──────────────────┘  │
└─────────────────────────────────────────────────────────────────────────────┘

Core surfaces

  • 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

Operating principles

Every deployment follows documented guardrails: immutable infrastructure, TLS enforcement, access logging, and AI/human collaboration workflows recorded in the 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 captures admin/API/worker health plus backup timers into zenpower/docs/en/status/health_matrix.json.
  5. Audit: Deployment history appended to docs/en/status/deploy_log.md; landing links surface these achievements.
Documentation map

Curated public-safe references

The lists below reference documentation families that can be shared externally. Private material remains within the Git repository and is not exposed here.

Need deeper insight? Request temporary GitHub access or consult the internal knowledge base via ZenControl. All access is logged and reviewed.

Explore the Zenpower surfaces

Each module shares the same synthwave calm—pick a surface to keep exploring.

CORE

Docs Portal

Navigable knowledge with manifest-driven deep links.

Explore docs

CORE

Account Settings

Manage your wallet profile, preferences, and linked services.

Manage account

CORE

Marketplace

Browse and trade digital assets within the ecosystem.

Browse market