mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
Every page now loads /webmcp.js, scripts/webmcp.ts with its types stripped (npm run webmcp). Where the browser has document.modelContext it registers two read-only tools: search_skills over the published skills index, and get_skill, which returns a skill's markdown checked against the index digest. The markdown alternate link moves from build.py to site.py, so CI holds every page to it. The API catalog gains the site itself (llms.txt and the skills index) and hanzo.ai/agents; the live discovery check now fetches every catalog link. tests/site.mjs drives the tools through a recording modelContext, and checks a browser without one loads clean.
364 lines
22 KiB
HTML
364 lines
22 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-stack</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="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-stack">
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-stack.md">
|
|
<script type="module" src="/webmcp.js"></script>
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-stack.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-stack</h1><p class="lede">Hanzo Stack provides the complete integrated development environment for running all Hanzo services locally.</p><h1>Hanzo Stack - Full Integrated Development Environment</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-llm-gateway.md</code>, <code>hanzo/hanzo-cloud.md</code>, <code>hanzo/hanzo-database.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Hanzo Stack provides the <strong>complete integrated development environment</strong> for running all Hanzo services locally. One command to start everything: LLM Gateway, Chat, Console, Cloud, IAM, KMS, PostgreSQL, Redis, MongoDB, MinIO.</p>
|
|
<p><strong>NOTE</strong>: The stack uses <strong>three compose files</strong> (production, development, core) and <strong>git submodules</strong> for all services, allowing each service to track its own repo while being orchestrated together.</p>
|
|
<h3>Why Hanzo Stack?</h3>
|
|
<ul><li><strong>One-command setup</strong>: <code>make dev</code> starts everything</li><li><strong>Three compose profiles</strong>: Production, development (hot-reload), core (minimal)</li><li><strong>Git submodules</strong>: Each service tracks its own repo</li><li><strong>Full ecosystem</strong>: All Hanzo services running locally</li><li><strong>Hot-reload</strong>: Development mode with file watching</li><li><strong>Consistent</strong>: Same compose config for all developers</li><li><strong>Offline-capable</strong>: Local models via LLM Gateway + Ollama</li></ul>
|
|
<h2>When to use</h2>
|
|
<ul><li>Local development across multiple Hanzo services</li><li>Testing integrations between Hanzo components</li><li>Full-stack AI application development</li><li>Onboarding new team members</li><li>Reproducing production issues locally</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>Docker</strong> with compose v2</li><li><strong>16GB+ RAM</strong> (recommended for full stack)</li><li><strong>make</strong> (standard on macOS/Linux)</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | Repo | <code>github.com/hanzoai</code> (experiments/stack directory) | | Setup | <code>make setup</code> | | Start prod | <code>make up</code> | | Start dev | <code>make dev</code> | | Start core | <code>make core</code> | | Status | <code>make status</code> | | Stop | <code>make down</code> | | Logs | <code>make logs</code> |</p>
|
|
<h2>Three Compose Files</h2>
|
|
<p>| File | Purpose | Services | |------|---------|----------| | <code>compose.yml</code> | <strong>Production</strong> — optimized, no hot-reload | All services, release images | | <code>compose.dev.yml</code> | <strong>Development</strong> — hot-reload, source mounts | All services, volume mounts | | <code>compose.core.yml</code> | <strong>Core</strong> — minimal set for quick start | LLM Gateway, Chat, PostgreSQL, Redis |</p>
|
|
<pre><code class="lang-bash"># Production mode
|
|
make up # Uses compose.yml
|
|
|
|
# Development mode (hot-reload)
|
|
make dev # Uses compose.yml + compose.dev.yml override
|
|
|
|
# Core only (minimal, fast startup)
|
|
make core # Uses compose.core.yml</code></pre>
|
|
<h2>Git Submodules</h2>
|
|
<p>Each service is a git submodule tracking its own repo:</p>
|
|
<pre><code>experiments/stack/
|
|
├── services/
|
|
│ ├── llm/ → github.com/hanzoai/llm (LLM Gateway)
|
|
│ ├── chat/ → github.com/hanzoai/chat (Chat UI)
|
|
│ ├── console/ → github.com/hanzoai/console (Console)
|
|
│ ├── cloud/ → github.com/hanzoai/cloud (Cloud Dashboard)
|
|
│ ├── search/ → github.com/hanzoai/search (Search)
|
|
│ ├── commerce/ → github.com/hanzoai/commerce (Commerce API)
|
|
│ └── ...
|
|
├── compose.yml # Production compose
|
|
├── compose.dev.yml # Development overrides
|
|
├── compose.core.yml # Minimal core services
|
|
├── .env.example # Environment template
|
|
├── Makefile # All commands
|
|
└── README.md</code></pre>
|
|
<pre><code class="lang-bash"># Initialize submodules
|
|
git submodule update --init --recursive
|
|
|
|
# Update all submodules to latest
|
|
git submodule update --remote
|
|
|
|
# Update specific service
|
|
cd services/chat && git pull origin main</code></pre>
|
|
<h2>Service Ports</h2>
|
|
<p>| Service | Port | URL | Description | |---------|------|-----|-------------| | Search UI | 3000 | <code>http://localhost:3000</code> | AI-powered search | | Chat UI | 3081 | <code>http://localhost:3081</code> | Hanzo Chat | | LLM Gateway | 4000 | <code>http://localhost:4000</code> | Unified LLM proxy | | Payment API | 4242 | <code>http://localhost:4242</code> | Commerce API | | Admin UI | 5173 | <code>http://localhost:5173</code> | Admin dashboard | | Core API | 8000 | <code>http://localhost:8000</code> | Main API server | | PostgreSQL | 5432 | <code>postgresql://localhost:5432</code> | Primary database | | Redis | 6379 | <code>redis://localhost:6379</code> | Cache/queues | | MongoDB | 27017 | <code>mongodb://localhost:27017</code> | Document storage | | MinIO | 9000 | <code>http://localhost:9000</code> | S3-compatible storage | | Prometheus | 9090 | <code>http://localhost:9090</code> | Metrics collection |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<pre><code class="lang-bash"># Clone and setup
|
|
git clone --recurse-submodules https://github.com/hanzoai/experiments.git
|
|
cd experiments/stack
|
|
|
|
# Configure environment
|
|
make setup # Creates .env from .env.example, prompts for API keys
|
|
|
|
# Start all services (pick one)
|
|
make core # Minimal: LLM + Chat + Postgres + Redis
|
|
make dev # Full stack with hot-reload
|
|
make up # Full stack, production mode
|
|
|
|
# Verify
|
|
make status # Check all services are healthy
|
|
curl http://localhost:4000/v1/models # List available models
|
|
curl http://localhost:3081 # Open Chat UI</code></pre>
|
|
<h2>Makefile Commands</h2>
|
|
<pre><code class="lang-bash">make setup # Initial setup (env, pull images, init submodules)
|
|
make up # Start all services (production mode)
|
|
make dev # Start with hot-reload (development)
|
|
make core # Start minimal core services only
|
|
make down # Stop all services
|
|
make restart # Restart all services
|
|
make status # Show service status and health
|
|
make logs # Stream all logs
|
|
make logs-llm # Stream LLM Gateway logs only
|
|
make logs-chat # Stream Chat logs only
|
|
make clean # Remove volumes and data
|
|
make pull # Pull latest images
|
|
make build # Build local images
|
|
make test # Run integration tests
|
|
make reset # Full reset (clean + setup)
|
|
make update # Update all git submodules</code></pre>
|
|
<h2>Environment Configuration</h2>
|
|
<pre><code class="lang-bash"># .env (created by make setup)
|
|
|
|
# Required: At least one LLM provider
|
|
OPENAI_API_KEY=sk-...
|
|
ANTHROPIC_API_KEY=sk-ant-...
|
|
HANZO_API_KEY=hanzo-...
|
|
|
|
# Optional: Local models
|
|
OLLAMA_URL=http://host.docker.internal:11434
|
|
|
|
# Database
|
|
DATABASE_URL=postgresql://hanzo:hanzo@postgres:5432/hanzo
|
|
REDIS_URL=redis://redis:6379
|
|
|
|
# IAM
|
|
IAM_ENDPOINT=https://hanzo.id
|
|
IAM_CLIENT_ID=app-hanzo
|
|
IAM_CLIENT_SECRET=secret
|
|
|
|
# KMS
|
|
KMS_ENDPOINT=https://kms.hanzo.ai
|
|
KMS_CLIENT_ID=...
|
|
KMS_CLIENT_SECRET=...</code></pre>
|
|
<h2>Compose Architecture</h2>
|
|
<pre><code>┌─────────────────────────────────────────┐
|
|
│ compose.yml + compose.dev.yml │
|
|
├─────────────────────────────────────────┤
|
|
│ │
|
|
│ ┌──────────┐ ┌──────────┐ ┌───────┐ │
|
|
│ │ Chat UI │ │ Search │ │ Admin │ │
|
|
│ │ :3081 │ │ :3000 │ │ :5173 │ │
|
|
│ └────┬─────┘ └────┬─────┘ └───┬───┘ │
|
|
│ │ │ │ │
|
|
│ ┌────┴──────────────┴────────────┴───┐ │
|
|
│ │ LLM Gateway :4000 │ │
|
|
│ └────────────────┬───────────────────┘ │
|
|
│ │ │
|
|
│ ┌────────────────┴───────────────────┐ │
|
|
│ │ Core API :8000 │ │
|
|
│ └──┬─────────┬──────────┬───────────┘ │
|
|
│ │ │ │ │
|
|
│ ┌──┴───┐ ┌──┴───┐ ┌───┴────┐ ┌─────┐│
|
|
│ │Postgres│ │Redis │ │MongoDB │ │MinIO││
|
|
│ │ :5432 │ │:6379 │ │ :27017 │ │:9000││
|
|
│ └───────┘ └──────┘ └────────┘ └─────┘│
|
|
└─────────────────────────────────────────┘</code></pre>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | Port conflict | Service already running | <code>lsof -i :PORT && kill PID</code> | | OOM | Too many services | Use <code>make core</code> for minimal stack | | Slow start | Image pull | <code>make pull</code> beforehand | | DB connection fail | Postgres not ready | Wait or <code>make restart</code> | | Chat not loading | Missing OPENAI_API_KEY | Add at least one LLM key to .env | | Submodule empty | Not initialized | <code>git submodule update --init --recursive</code> |</p>
|
|
<pre><code class="lang-bash"># Debug specific service
|
|
docker compose logs -f llm-gateway
|
|
docker compose exec postgres psql -U hanzo
|
|
|
|
# Reset everything
|
|
make clean && make setup && make dev
|
|
|
|
# Port conflicts
|
|
lsof -i :4000 # Find what's using the port</code></pre>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-llm-gateway.md</code> - LLM proxy (port 4000)</li><li><code>hanzo/hanzo-chat.md</code> - Chat UI (port 3081)</li><li><code>hanzo/hanzo-database.md</code> - PostgreSQL/Redis setup</li><li><code>hanzo/hanzo-o11y.md</code> - Monitoring (Prometheus port 9090)</li><li><code>hanzo/hanzo-universe.md</code> - Production K8s (vs local stack)</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: stack, development, local, docker, compose, submodules <strong>Prerequisites</strong>: Docker, make, 16GB+ RAM</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-stack.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |