Files
skills/public/hanzo-chat.md

1.8 KiB

Hanzo Chat

AI chat interface with multi-model support, MCP integration, agents, and RAG.

URLs

  • Production: hanzo.chat, chat.hanzo.ai
  • IAM Client ID: hanzo-chat
  • Docker Image: ghcr.io/hanzoai/chat:main

Tech Stack

  • Runtime: Node.js 20 (Alpine)
  • Backend: Express.js (api/server/)
  • Frontend: React + Vite (client/)
  • Database: MongoDB (DocumentDB)
  • Search: Meilisearch
  • Package Manager: pnpm 10.x (Dockerfile uses pnpm install --frozen-lockfile)

Key Files

  • api/server/ — Express backend (port 3080)
  • api/strategies/openidStrategy.js — OIDC SSO via hanzo.id (Host header injection for internal IAM rewrite)
  • client/ — React frontend (Vite)
  • packages/api/ — API client (@librechat/api)
  • packages/mcp/ — MCP server integration
  • librechat.yaml / ConfigMap chat-config — runtime config

Auth

  • SSO via hanzo.id OIDC (OPENID_ISSUER=https://hanzo.id, OPENID_CLIENT_ID=hanzo-chat)
  • /oauth/openid redirects to hanzo.id (302)
  • ALLOW_EMAIL_LOGIN=false, ALLOW_REGISTRATION=false
  • Social login: Google, GitHub, Wallet

Build & Deploy

pnpm install --frozen-lockfile
pnpm run build:packages
pnpm run frontend
  • K8s: deployment/chat, port 3080
  • CI: docker-publish.yml → shared docker-build.yml workflow
  • Image: ghcr.io/hanzoai/chat:main (multi-arch amd64+arm64)

Known Issues (2026-03-26)

  • @modelcontextprotocol/sdk pinned to 1.25.3 via pnpm.overrides (1.26+ requires zod/v4 which breaks)
  • zod-to-json-schema pinned to 3.24.6 via pnpm.overrides (3.25+ requires zod/v4)
  • Internal package names kept from upstream: @librechat/api, librechat-data-provider

Upstream

  • Fork of: danny-avila/LibreChat
  • Behind upstream: ~3,200 commits
  • Branding: Hanzo red #fd4444, "Hanzo Chat" title, H logo