zeekay a4e7105161 docs(services): correct S3/IAM/KMS/MPC/Base/PaaS to real /v1 surfaces
Audited each service's current source and rewrote the docs to match:
- S3: SeaweedFS-based (was documented as MinIO) - S3 SigV4, real clients
  (mc/aws/boto3), correct ports; dropped fabricated SDKs + cross-brand buckets
- IAM: Casdoor fork - canonical /v1/iam/* OIDC, <org>-<app> app convention,
  JWKS token validation, per-host white-label
- KMS: Go /v1/kms surface - machine-identity login, org/path/name?env reads
  with CAS, KMSSecret keys[]; removed fabricated /api/v1 + SDK examples
- MPC: /v1/mpc custody API with session-based signing; CGGMP21/FROST/LSS/BLS
- Base: PocketBase fork on /v1 - IAM-native auth (local passwords removed),
  real endpoints incl /v1/sql, /v1/tasks, /v1/private
- PaaS: Dokploy fork (SQLite/Base) - /v1 container redeploy + /api
  application.* build pipeline; replaced fabricated Mongo/Redis architecture

House style: /v1 not /api, api.<svc>.hanzo.ai hosts, KMS paths for secrets,
Hanzo-only (stripped Lux/Zoo leaks, prod IPs, nginx, internal slugs).
2026-06-26 11:55:49 -07:00
2024-04-26 21:51:12 +08:00
2026-04-17 22:50:22 +08:00
2023-07-30 22:03:19 +08:00
2026-05-29 18:22:54 +08:00
2025-12-30 16:49:34 +08:00
2023-07-30 15:46:09 +08:00

Hanzo Docs

The documentation framework for Hanzo AI, Lux Network, Zoo Labs Foundation, and Zen LM.

A powerful React.js documentation framework built for the Hanzo ecosystem.

Features

  • Multi-Brand Support: Unified framework supporting Hanzo, Lux, Zoo, and Zen documentation
  • Next.js 15+: Built on the latest Next.js with App Router
  • MDX: Write documentation in MDX with full component support
  • Search: Built-in search with Orama and Algolia support
  • TypeScript: Full TypeScript support with auto-generated API docs
  • OpenAPI: Generate interactive API documentation from OpenAPI specs
  • i18n: Internationalization support for multiple languages
  • Themes: Customizable themes with dark mode support

Quick Start

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

Project Structure

.
├── apps/
│   ├── docs/              # Main documentation site
│   ├── dev-docs/          # Hanzo Dev CLI docs
│   ├── zen-docs/          # Zen LM model docs (zenlm.org)
│   ├── zap-docs/          # ZAP protocol docs
│   └── bot-docs/          # Bot documentation
├── packages/
│   ├── brand/             # Brand configuration (Hanzo, Lux, Zoo)
│   ├── core/              # Core functionality
│   ├── ui/                # UI components
│   ├── mdx/               # MDX processing
│   ├── openapi/           # OpenAPI integration
│   └── ...                # Other packages
└── examples/              # Example implementations

Brand Configuration

Set the brand via environment variable:

# .env.local
NEXT_PUBLIC_BRAND=hanzo  # or 'lux', 'zoo', or 'zen'

Available Brands

Brand Organization Documentation
hanzo Hanzo AI Inc hanzoai.github.io/docs
lux Lux Network docs.lux.network
zoo Zoo Labs Foundation docs.zoo.ngo
zen Zen LM zenlm.org

Development

Prerequisites

  • Node.js 18.17+
  • pnpm 10+

Commands

# Development
pnpm dev              # Start all apps in dev mode
pnpm dev:all          # Start docs app only
pnpm dev:examples     # Start example apps

# Build
pnpm build            # Build all packages
pnpm clean            # Clean build artifacts

# Quality
pnpm lint             # Run ESLint
pnpm lint:prettier    # Check formatting
pnpm prettier         # Fix formatting
pnpm test             # Run tests
pnpm types:check      # Type check

Documentation Sites

Hanzo Docs (hanzoai.github.io/docs)

Documentation for Hanzo AI infrastructure including:

  • LLM Gateway
  • Agent SDK
  • MCP Tools
  • Chat Platform
  • Python/JS SDKs

Lux Docs (docs.lux.network)

Documentation for Lux Network including:

  • Architecture & Consensus
  • Node Operation
  • SDK & CLI
  • Smart Contracts
  • Post-Quantum Security

Zoo Docs (docs.zoo.ngo)

Documentation for Zoo Labs Foundation including:

  • DSO Protocol
  • Proof of AI (PoAI)
  • Zen Model Family
  • Gym SDK
  • Training Infrastructure

Forking for New Brands

  1. Clone this repository
  2. Create brand config in packages/brand/src/brands/
  3. Add CSS in packages/brand/css/
  4. Update the brands registry
  5. Set NEXT_PUBLIC_BRAND environment variable

Contributing

Please read the Contributing Guide before submitting a pull request.

License

MIT © Hanzo AI Inc


Built with Hanzo Docs

S
Description
No description provided
Readme MIT
470 MiB
Languages
TypeScript 41.7%
MDX 34.6%
JavaScript 20.5%
CSS 1.3%
XSLT 0.7%
Other 1%