System Architecture

Zeq OS Hub is a self-hosted platform where all services run behind a single nginx reverse proxy. Everything is accessible from one domain — no port numbers, no scattered services.

Architecture Layers

┌───────────────────────────────────────────────────────────┐
│                    NGINX REVERSE PROXY                     │
│            Single domain · SSL · Rate limiting             │
├──────────┬──────────┬──────────┬──────────┬──────────────┤
│  DOCS    │   AI     │  COLLAB  │  APPS    │   SERVICES   │
│  /       │  /chat/  │  /git/   │  /apps/* │   /api/      │
│  /docs/* │          │  /forum/ │          │   /ws        │
│  /blog   │          │  /search │          │   /sync/     │
├──────────┴──────────┴──────────┴──────────┴──────────────┤
│                    SDK LAYER (MIDDLEWARE)                   │
│     Python · JavaScript · Rust · Go · C++ · WASM          │
│     HulyaSync · ZeqProcessor · OperatorRegistry           │
├───────────────────────────────────────────────────────────┤
│                    OPERATOR REGISTRY                       │
│          1,576 operators · 64 categories · v6.3.0          │
│          operator-registry.json (shared source of truth)   │
├───────────────────────────────────────────────────────────┤
│                    DATA LAYER                              │
│          MongoDB · Redis · PostgreSQL                      │
└───────────────────────────────────────────────────────────┘

Service Map

All services are accessible through the nginx reverse proxy under a single domain. In production, replace localhost with your domain.

Documentation & Site

Route	Service	Technology	Purpose
/	Docusaurus	React SSG	Main website, SDK docs, operator reference, blog
/docs/*	Docusaurus	Markdown	SDK guides, framework docs, tutorials
/blog	Docusaurus	Markdown	Release notes, research updates

AI & Intelligence

Route	Service	Technology	Purpose
/chat/	Zeq MI	Node.js	Multi-model AI chat with Zeq OS MCP tools
/apps/zeq-chat/	Zeq Chat	Static HTML	Lightweight chat synchronized to 1.287 Hz

Developer Services

Route	Service	Technology	Purpose
/api/	API Gateway	Express.js	REST API — operator execution, auth, rate limiting
/api-docs	Swagger UI	OpenAPI	Interactive API documentation
/ws	Sync Engine	WebSocket	Real-time HulyaPulse broadcast at 1.287 Hz
/sync/	Sync Engine	Express.js	Sync HTTP endpoints
/git/	Zeq Git	Go	Private Git hosting with CI/CD
/search/	Zeq Search	Python	Privacy-respecting metasearch (70+ engines)

Physics & Math

Route	Service	Technology	Purpose
/services/wizard/	7-Step Wizard	Python/FastAPI	Interactive wizard API with Swagger docs
/services/forensic/	HF Forensic Suite	Python/Flask	20 forensic scoring functions
/apps/physics-wizard/	Physics Wizard Game	Static HTML	100 interactive physics challenges

Security & Encryption

Route	Service	Technology	Purpose
/apps/hite/	HITE Encryption	Static HTML	AES-256-GCM with temporal entanglement
/apps/tesc/	TESC Chat	Static HTML	Physics-locked messaging (0.777s PLATs)
/apps/dashboard/	ZeqBoard	Static HTML	Real-time monitoring, Shannon entropy

Infrastructure

Route	Service	Technology	Purpose
/services/daemon/	Zeqond Daemon	Python	HulyaPulse clock, Unix/Zeqond bridge
/services/sandbox/	Code Sandbox	Node.js	Sandboxed code execution (MCP)
/forum/	Discourse	Ruby/Rails	Community forum with Zeq Git SSO

SDKs

Zeq OS is a middleware framework. The SDKs are the primary way developers interact with the operator registry and computation engine. All SDKs share the same operator-registry.json as their source of truth.

SDK	Language	Install	Key Feature
Python	Python 3.9+	pip install zeq-os	Reference implementation, NumPy integration
JavaScript	Node 18+	npm install @zeq-os/sdk	Browser + Node.js, ES modules
TypeScript	TypeScript 5.3+	npm install @zeq-os/sdk-types	Full type definitions for JS SDK
Rust	Rust 2021	cargo add zeq-os	High-performance, compiles to WASM
Go	Go 1.21+	go get github.com/hulyasmath/zeq-os/sdk/go	Microservices, concurrent processing
C++	C++17	Header-only (clone and include)	Real-time systems, embedded
WebAssembly	Rust→WASM	wasm-pack build	Browser-native, client-side physics

Forked Open-Source Projects

The hub includes full forks of open-source projects, integrated into the Zeq OS ecosystem:

Project	Purpose	Location
Zeq Git	Private Git hosting	infra/gitea/gitea-main/
Discourse	Community forum	infra/discourse/discourse-main/
Docusaurus	Documentation platform	docs/
Zeq MI	AI chat interface	apps/mi-chat-ai/
DocsGPT	AI documentation assistant	infra/docsgpt/DocsGPT-main/
Zeq Search	Metasearch engine	infra/searxng/

Docker Deployment

All services run as Docker containers orchestrated via Docker Compose. nginx sits in front as the single entry point.

nginx:80 ─┬→ Docusaurus (static build)
           ├→ API Gateway (Express.js)
           ├→ Sync Engine (WebSocket)
           ├→ Zeq MI (Node.js)
           ├→ Zeq Git (Go)
           ├→ 7-Step Wizard (FastAPI)
           ├→ Forensic Suite (Flask)
           ├→ Zeqond Daemon (Python)
           ├→ Zeq Search (Python)
           ├→ Code Sandbox (Node.js)
           └→ Static HTML Apps (served by nginx)

See the Deployment Guide for setup instructions.