zeekay
cdb6f9d091
The console sat on @hanzo/gui 7.3.0 / @hanzogui/shell 7.6.3 while the gui line shipped 8.0.0, so every shell fix landed on main and stopped there: cloud.hanzo.ai and console.hanzo.ai kept serving a header from a package that could not move. What actually pinned it was a phantom peer. Every published @hanzogui/shell declared `@hanzo/iam@^0.13.1` — a package it never imported — and for a 0.x range the caret pins the minor, so once IAM reached 0.21.2 the range was unsatisfiable and the 8.x line was uninstallable. Fixed at the source and released as @hanzogui/shell@8.0.1 with zero dependencies. typescript goes ^7.0.2 -> ^5.8.2 in the same commit because it has to: Next 15 does not support TS 7, and on 7.0.2 `next dev` fails to a bare "Cannot read properties of undefined (reading 'endsWith')" after silently installing a 5.x behind your back. Same fix hanzo.ai just made. Verified on the real 8.x tree at 1440x900 and 390x844: Products opens as FIVE columns with all ten categories visible and nothing clipped (it was four columns with WEB3 + APPS below the fold), one "Sign in" pointing at /signin, one h1, the hero primary a white 999px pill, and Terms inside the viewport with no underline and no horizontal overflow.
Hanzo Cloud Console
Unified admin console for Hanzo Cloud and all Hanzo cloud products. Built on
@hanzo/gui (cross-platform UI) over the unified /v1
backend (hanzoai/cloud). Dark theme, OIDC sign-in via Hanzo IAM.
Manages: Providers · Models · Applications · Stores · Chat — with an extensible product-module registry so every cloud product can be added as a module.
Quick start
npm install
cp .env.example .env.local
# set NEXT_PUBLIC_IAM_CLIENT_ID for live sign-in; defaults point at production.
npm run dev # http://localhost:4000
Scripts
| Script | What |
|---|---|
npm run dev |
Dev server on :4000 |
npm run build |
Production build (type-checks; Gui CSS injected at runtime) |
npm run start |
Serve the production build |
npm run typecheck |
tsc --noEmit (strict) |
Configuration
All config is NEXT_PUBLIC_* (browser app, cookie auth). See .env.example.
| Var | Default | Meaning |
|---|---|---|
NEXT_PUBLIC_CLOUD_URL |
same origin, else https://api.hanzo.ai |
The ONE Hanzo API endpoint (unified /v1 backend). Never a per-service API host. |
NEXT_PUBLIC_IAM_URL |
https://iam.hanzo.ai |
Hanzo IAM OIDC authority |
NEXT_PUBLIC_IAM_APP_NAME |
hanzo-console |
IAM application (<org>-<app>) |
NEXT_PUBLIC_IAM_ORG_NAME |
hanzo |
IAM organization |
NEXT_PUBLIC_IAM_CLIENT_ID |
— | OAuth client id |
Architecture
See LLM.md for the full design (base choice, /v1 client, auth flow, the product-module registry, and the Providers surface). Endpoint reference in docs/endpoints.md.
License
BSD-3-Clause. Copyright (c) 2026-present, Hanzo AI, Inc.