Files
skills/public/hanzo-platform.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

341 lines
19 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hanzo-platform</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/hanzo-platform.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-platform">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-platform.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>hanzo-platform</h1><p class="lede">Hanzo Platform is a Kubernetes-native PaaS (Platform as a Service) for deploying AI applications, APIs, and services.</p><p>&lt;!-- Updated: 2026-03-26T15:03:36Z --&gt;</p>
<h1>Hanzo Platform - Cloud PaaS for AI Applications</h1>
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-cloud.md</code>, <code>hanzo/hanzo-id.md</code>, <code>hanzo/hanzo-kms.md</code>, <code>hanzo/hanzo-k8s.md</code></p>
<h2>Overview</h2>
<p>Hanzo Platform is a <strong>Kubernetes-native PaaS</strong> (Platform as a Service) for deploying AI applications, APIs, and services. Hono.js + tRPC + Drizzle ORM API backend with Next.js 16 frontend. Turborepo monorepo. Fork of Dokploy. Live at <code>platform.hanzo.ai</code>.</p>
<h2>When to use</h2>
<ul><li>Deploying Docker containers or applications to K8s</li><li>Managing environments (staging, production) with git-push deploys</li><li>Self-hosting a PaaS platform for your team</li><li>White-labeling a deployment platform</li></ul>
<h2>Hard requirements</h2>
<ol><li><strong>Kubernetes cluster</strong> with <code>hanzo-paas-sa</code> service account</li><li><strong>IAM</strong> configured at hanzo.id for authentication (provider <code>hanzo</code>, NOT <code>github</code>)</li><li><strong>KMS</strong> at kms.hanzo.ai for secrets (KMSSecret CRDs, never plaintext)</li><li><strong>GHCR access</strong> for container images</li><li><strong>No nginx, no caddy</strong> -- Hanzo Ingress (Traefik) handles routing</li><li><strong>Self-hosted runners only</strong> for CI/CD -- never GitHub Actions on hanzoai org</li></ol>
<h2>Quick reference</h2>
<p>| Item | Value | |------|-------| | UI | <code>https://platform.hanzo.ai</code> | | API | <code>https://platform.hanzo.ai/v1</code> | | Auth | IAM via hanzo.id (OAuth2, provider=<code>hanzo</code>) | | Images | <code>ghcr.io/hanzoai/paas-{api,studio,monitor,sync,webhook}:latest</code> | | K8s SA | <code>hanzo-paas-sa</code> | | KMS Project | <code>hanzo-paas</code> (slug must be &gt;= 5 chars) | | Repo | <code>github.com/hanzoai/paas</code> | | API port | 4000 (Hono.js + tRPC) | | Frontend port | 3000 (Next.js 16) | | Build | Turborepo + pnpm workspace | | K8s namespace | <code>hanzo</code> | | K8s manifests | <code>universe/infra/k8s/paas/</code> |</p>
<h2>Architecture</h2>
<pre><code> platform.hanzo.ai
|
+----------+----------+
| |
Studio UI PaaS API
(Next.js 16) (Hono.js + tRPC)
port 3000 port 4000
| |
+----------+----------+
|
+------+------+
| | |
Monitor Sync Webhook
(health) (git) (deploy)
|
+------+------+
| |
PostgreSQL K8s Cluster
(Drizzle) (workloads)</code></pre>
<h2>Auth flow</h2>
<p>Platform uses <code>provider=hanzo</code> via Better Auth generic OAuth.</p>
<ol><li>User clicks &quot;Sign in with Hanzo&quot; on platform.hanzo.ai</li><li>Redirected to hanzo.id for authentication</li><li>Token returned to platform via callback</li><li>Token validated against IAM userinfo endpoint</li></ol>
<p><strong>CRITICAL</strong>: <code>platform/app/platform/pages/index.tsx</code> MUST target provider <code>&quot;hanzo&quot;</code> (NOT <code>&quot;github&quot;</code>).</p>
<h3>IAM environment variables (canonical <code>IAM_*</code> contract)</h3>
<pre><code class="lang-bash"># IAM server endpoint
IAM_ENDPOINT=https://hanzo.id
# IAM client credentials (per-app, sourced from KMS)
IAM_CLIENT_ID=app-hanzo
IAM_CLIENT_SECRET=secret
# Optional: OIDC issuer, userinfo URL, signing cert
IAM_ISSUER=https://hanzo.id
IAM_USERINFO_URL=https://hanzo.id/v1/iam/oauth/userinfo
IAM_ORG=hanzo
IAM_APP=app-hanzo</code></pre>
<p>Auth validator supports <code>provider=hanzo</code> by validating bearer tokens against IAM userinfo (<code>IAM_USERINFO_URL</code> / <code>IAM_ENDPOINT</code>).</p>
<h2>KMS integration</h2>
<p>All secrets are KMS-first. No plaintext in manifests.</p>
<pre><code class="lang-yaml"># universe/infra/k8s/paas/secrets.yaml
apiVersion: kms.hanzo.ai/v1
kind: KMSSecret
metadata:
name: hanzo-paas
spec:
project: hanzo-paas
environment: production
secrets:
- DOCKERHUB_USERNAME
- DOCKERHUB_TOKEN
- DIGITALOCEAN_ACCESS_TOKEN</code></pre>
<p>CI/CD also pulls from KMS at runtime:</p>
<pre><code class="lang-yaml"># paas/.github/workflows/deploy.yml
jobs:
deploy:
steps:
- name: Login to KMS
run: |
export KMS_TOKEN=$(curl -s -X POST $KMS_URL/api/v1/auth/universal-auth/login \
-d &#x27;{&quot;clientId&quot;:&quot;...&quot;,&quot;clientSecret&quot;:&quot;...&quot;}&#x27; | jq -r &#x27;.accessToken&#x27;)
- name: Fetch deploy secrets
run: |
DOCKERHUB_TOKEN=$(curl -s &quot;$KMS_URL/api/v1/secrets/raw/DOCKERHUB_TOKEN?...&quot; \
-H &quot;Authorization: Bearer $KMS_TOKEN&quot; | jq -r &#x27;.secret.secretValue&#x27;)</code></pre>
<h2>Deploy an app via API</h2>
<pre><code class="lang-bash">curl -X POST https://platform.hanzo.ai/v1/projects \
-H &quot;Authorization: Bearer ${HANZO_TOKEN}&quot; \
-H &quot;Content-Type: application/json&quot; \
-d &#x27;{
&quot;name&quot;: &quot;my-ai-app&quot;,
&quot;environment&quot;: &quot;production&quot;,
&quot;image&quot;: &quot;ghcr.io/myorg/my-app:latest&quot;,
&quot;port&quot;: 3000,
&quot;replicas&quot;: 2
}&#x27;</code></pre>
<h2>Self-host via Docker Compose</h2>
<pre><code class="lang-yaml"># compose.yml
services:
paas-api:
image: ghcr.io/hanzoai/paas-api:latest
ports:
- &quot;4000:4000&quot;
environment:
IAM_ENDPOINT: https://hanzo.id
KMS_ENDPOINT: https://kms.hanzo.ai
DATABASE_URL: postgresql://user:pass@postgres:5432/paas
REDIS_URL: redis://redis:6379
paas-studio:
image: ghcr.io/hanzoai/paas-studio:latest
ports:
- &quot;5173:5173&quot;
environment:
API_URL: http://paas-api:4000
postgres:
image: ghcr.io/hanzoai/sql:latest
environment:
POSTGRES_DB: paas
POSTGRES_USER: paas
redis:
image: ghcr.io/hanzoai/kv:latest</code></pre>
<h2>White-label / self-host</h2>
<ol><li>Fork <code>hanzoai/paas</code></li><li>Update branding in <code>paas-studio/</code></li><li>Configure IAM provider (any Hanzo IAM/OIDC)</li><li>Deploy to your K8s cluster</li><li>Set custom domain via Ingress</li></ol>
<h2>Troubleshooting</h2>
<p>| Issue | Cause | Solution | |-------|-------|----------| | &quot;Sign in with Hanzo&quot; fails | Provider set to <code>&quot;github&quot;</code> | Change to <code>&quot;hanzo&quot;</code> in index.tsx | | KMS slug error | Slug &lt; 5 chars | Use <code>hanzo-paas</code> not <code>paas</code> | | Token expired | <code>expireInHours=0</code> on Hanzo IAM app | Set <code>expireInHours=168</code> | | Duplicate users on IAM login | Email match not attempted | Auth falls back to email match for existing users | | Studio login fails for non-git | <code>addGitProvider</code> called for IAM | Studio loader treats <code>hanzo</code> as first-class, skips <code>addGitProvider</code> |</p>
<h2>Related Skills</h2>
<ul><li><code>hanzo/hanzo-id.md</code> -- IAM and authentication</li><li><code>hanzo/hanzo-kms.md</code> -- Secret management</li><li><code>hanzo/hanzo-k8s.md</code> -- K8s infrastructure</li><li><code>hanzo/hanzo-deploy.md</code> -- Deployment workflow</li><li><code>hanzo/hanzo-ingress.md</code> -- Ingress routing</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2026-03-23 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: paas, deployment, kubernetes, platform, dokploy <strong>Prerequisites</strong>: Kubernetes, Docker, OAuth2 basics</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/hanzo-platform.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>