mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
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]>
359 lines
21 KiB
HTML
359 lines
21 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-console</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-console.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-console">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-console.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-console</h1><p class="lede">Hanzo Console is the observability and prompt management layer for AI applications.</p><h1>Hanzo Console - AI Observability and Prompt Management</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-chat.md</code>, <code>hanzo/hanzo-cloud.md</code>, <code>hanzo/python-sdk.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Hanzo Console is the <strong>observability and prompt management layer</strong> for AI applications. Fork of Langfuse. Captures traces, scores, datasets, and prompts from any LLM application. Provides a dashboard for debugging, evaluation, and cost analysis. Compatible with the Langfuse SDK and OpenTelemetry. Live at <code>console.hanzo.ai</code>.</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Tracing and debugging LLM calls, tool use, and agent steps</li><li>Cost attribution per-request, per-user, per-model</li><li>Managing prompt versions and deployments</li><li>Building evaluation datasets and running automated scoring</li><li>Monitoring AI application performance and latency</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>API Key required</strong>: Use <code>HANZO_API_KEY</code> or Langfuse pair <code>LANGFUSE_PUBLIC_KEY</code> + <code>LANGFUSE_SECRET_KEY</code></li><li><strong>Never expose keys</strong> in user-visible output, logs, or screenshots</li><li><strong>Traces are async</strong>: SDK batches in background. Call <code>flush()</code> before process exit</li><li><strong>PostgreSQL backend</strong>: Console uses <code>console</code> database on <code>postgres.hanzo.svc</code></li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | Dashboard | <code>https://console.hanzo.ai</code> | | API Base | <code>https://console.hanzo.ai/api</code> | | Langfuse host | <code>https://console.hanzo.ai</code> | | Ingestion API | <code>https://console.hanzo.ai/api/public/ingestion</code> | | Auth (Hanzo) | <code>Authorization: Bearer ${HANZO_API_KEY}</code> | | Auth (Langfuse) | Basic auth with public/secret key pair | | Upstream | Langfuse | | Repo | <code>github.com/hanzoai/console</code> | | K8s manifests | <code>universe/infra/k8s/console/</code> | | Image | <code>ghcr.io/hanzoai/console:main</code> | | Worker Image | <code>ghcr.io/hanzoai/console-worker:main</code> | | Port | 3000 (web), 3030 (worker) | | IAM Client ID | hanzo-console | | Worker health | <code>/api/health</code> (NOT <code>/api/public/health</code>) |</p>
|
|
<h3>Recent Changes (2026-03-28)</h3>
|
|
<ul><li>Tracking embed + product keys section added to console settings</li><li>Worker readiness/liveness probes fixed: path <code>/api/public/health</code> → <code>/api/health</code></li><li>IAM OAuth provider registered (env: <code>IAM_CLIENT_ID</code>, <code>IAM_CLIENT_SECRET</code>, <code>IAM_SERVER_URL</code>)</li></ul>
|
|
<h2>Architecture</h2>
|
|
<pre><code>Your Application
|
|
|
|
|
Langfuse SDK / OTEL
|
|
|
|
|
console.hanzo.ai/api/public/ingestion
|
|
|
|
|
Console Backend (Node.js)
|
|
|
|
|
+---+---+
|
|
| |
|
|
PostgreSQL ClickHouse
|
|
(metadata) (traces, optional)</code></pre>
|
|
<p>Cloud API (<code>cloud.hanzo.ai</code>) POSTs traces to Console's ingestion endpoint for centralized observability.</p>
|
|
<h2>Python quickstart (Langfuse SDK)</h2>
|
|
<pre><code class="lang-python">from langfuse import Langfuse
|
|
|
|
lf = Langfuse(
|
|
host="https://console.hanzo.ai",
|
|
public_key=os.environ["LANGFUSE_PUBLIC_KEY"],
|
|
secret_key=os.environ["LANGFUSE_SECRET_KEY"],
|
|
)
|
|
|
|
# Create a trace
|
|
trace = lf.trace(name="chat-request", user_id="user_123")
|
|
|
|
# Log a generation (LLM call)
|
|
generation = trace.generation(
|
|
name="chat-completion",
|
|
model="zen-70b",
|
|
input=[{"role": "user", "content": "Hello!"}],
|
|
output="Hi there! How can I help?",
|
|
usage={"input": 5, "output": 8, "unit": "TOKENS"},
|
|
metadata={"temperature": 0.7},
|
|
)
|
|
|
|
# Score the trace
|
|
trace.score(name="quality", value=0.95, comment="Accurate and concise")
|
|
|
|
# Flush before exit
|
|
lf.flush()</code></pre>
|
|
<h2>Python quickstart (Hanzo SDK decorator)</h2>
|
|
<pre><code class="lang-python">from hanzo import Hanzo
|
|
from hanzo.console import observe
|
|
|
|
client = Hanzo() # uses HANZO_API_KEY from env
|
|
|
|
@observe()
|
|
def chat(message: str) -> str:
|
|
"""Automatically traced: input, output, latency, cost."""
|
|
response = client.chat.completions.create(
|
|
model="zen-70b",
|
|
messages=[{"role": "user", "content": message}],
|
|
)
|
|
return response.choices[0].message.content</code></pre>
|
|
<h2>Python quickstart (OpenAI drop-in)</h2>
|
|
<pre><code class="lang-python">from langfuse.openai import openai
|
|
|
|
# Drop-in replacement: all OpenAI calls auto-traced
|
|
openai.base_url = "https://api.hanzo.ai/v1"
|
|
openai.api_key = os.environ["HANZO_API_KEY"]
|
|
|
|
response = openai.chat.completions.create(
|
|
model="zen-70b",
|
|
messages=[{"role": "user", "content": "Hello!"}],
|
|
)
|
|
# Trace automatically sent to console.hanzo.ai</code></pre>
|
|
<h2>API reference</h2>
|
|
<h3>Traces</h3>
|
|
<p>| Method | Endpoint | Purpose | |--------|----------|---------| | POST | <code>/api/public/traces</code> | Create trace | | GET | <code>/api/public/traces/{id}</code> | Get trace | | GET | <code>/api/public/traces</code> | List traces |</p>
|
|
<h3>Generations (LLM calls)</h3>
|
|
<p>| Method | Endpoint | Purpose | |--------|----------|---------| | POST | <code>/api/public/generations</code> | Create generation | | PATCH | <code>/api/public/generations/{id}</code> | Update generation | | GET | <code>/api/public/generations</code> | List generations |</p>
|
|
<h3>Scores</h3>
|
|
<p>| Method | Endpoint | Purpose | |--------|----------|---------| | POST | <code>/api/public/scores</code> | Create score | | GET | <code>/api/public/scores</code> | List scores |</p>
|
|
<h3>Prompts</h3>
|
|
<p>| Method | Endpoint | Purpose | |--------|----------|---------| | POST | <code>/api/public/prompts</code> | Create prompt | | GET | <code>/api/public/prompts/{name}</code> | Get prompt (latest) | | GET | <code>/api/public/prompts/{name}/{version}</code> | Get prompt version | | GET | <code>/api/public/prompts</code> | List prompts |</p>
|
|
<h3>Datasets</h3>
|
|
<p>| Method | Endpoint | Purpose | |--------|----------|---------| | POST | <code>/api/public/datasets</code> | Create dataset | | GET | <code>/api/public/datasets</code> | List datasets | | POST | <code>/api/public/dataset-items</code> | Create dataset item | | POST | <code>/api/public/dataset-run-items</code> | Create dataset run |</p>
|
|
<h2>Prompt management</h2>
|
|
<p>Version, test, and deploy prompts from a central registry:</p>
|
|
<pre><code class="lang-python"># Get latest production prompt
|
|
prompt = lf.get_prompt("chat-system-prompt")
|
|
compiled = prompt.compile(user_name="Alice")
|
|
|
|
# Use in chat completion
|
|
response = client.chat.completions.create(
|
|
model="zen-70b",
|
|
messages=[
|
|
{"role": "system", "content": compiled},
|
|
{"role": "user", "content": "Hello!"},
|
|
],
|
|
langfuse_prompt=prompt, # links trace to prompt version
|
|
)</code></pre>
|
|
<h3>Prompt lifecycle</h3>
|
|
<ol><li><strong>Create</strong>: Author prompt in Console dashboard or via API</li><li><strong>Version</strong>: Each edit creates a new immutable version</li><li><strong>Label</strong>: Mark versions as <code>production</code>, <code>staging</code>, <code>latest</code></li><li><strong>Deploy</strong>: SDK fetches by label; no code change needed</li><li><strong>Evaluate</strong>: A/B test prompt versions against datasets</li></ol>
|
|
<h2>Multi-org bootstrap</h2>
|
|
<p>Console supports multi-org provisioning on startup:</p>
|
|
<pre><code class="lang-bash">HANZO_INIT_ORG_IDS=hanzo,lux,zoo,pars
|
|
HANZO_INIT_ORG_NAMES="Hanzo AI,Lux Network,Zoo Foundation,Pars"
|
|
[email protected]
|
|
HANZO_INIT_PROJECT_ORG_ID=hanzo</code></pre>
|
|
<h2>K8s deployment</h2>
|
|
<pre><code class="lang-yaml"># universe/infra/k8s/console/
|
|
apiVersion: apps/v1
|
|
kind: Deployment
|
|
metadata:
|
|
name: console
|
|
namespace: hanzo
|
|
spec:
|
|
replicas: 2
|
|
template:
|
|
spec:
|
|
containers:
|
|
- name: console
|
|
image: ghcr.io/hanzoai/console:latest
|
|
ports:
|
|
- containerPort: 3000
|
|
envFrom:
|
|
- secretRef:
|
|
name: console-secrets # KMS-synced
|
|
env:
|
|
- name: DATABASE_URL
|
|
value: postgresql://console:[email protected]:5432/console</code></pre>
|
|
<h2>Error handling</h2>
|
|
<p>| Code | Meaning | Action | |------|---------|--------| | 200 | Success | Process response | | 400 | Bad request | Check trace/generation format | | 401 | Unauthorized | Check API keys or Langfuse credentials | | 404 | Not found | Check trace/prompt/dataset ID | | 429 | Rate limited | SDK auto-retries; manual calls should back off | | 500 | Server error | Retry up to 3 times |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-cloud.md</code> -- Cloud API (sends traces to Console)</li><li><code>hanzo/hanzo-chat.md</code> -- Chat app (auto-instrumented)</li><li><code>hanzo/hanzo-o11y.md</code> -- Infrastructure observability (Hanzo o11y)</li><li><code>hanzo/python-sdk.md</code> -- Python SDK with <code>@observe()</code> decorator</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-23 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: observability, tracing, prompts, evaluation, langfuse, cost-tracking <strong>Prerequisites</strong>: Python or Node.js, Langfuse SDK or Hanzo SDK</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-console.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |