Files
skills/public/hanzo-datastore.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

389 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-datastore</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-datastore.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-datastore">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-datastore.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-datastore</h1><p class="lede">Hanzo Datastore provides a unified vector database abstraction for AI applications — embedding storage, similarity search, and RAG retrieval.</p><h1>Hanzo Datastore - Vector Database Integration</h1>
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-database.md</code>, <code>hanzo/hanzo-search.md</code>, <code>hanzo/hanzo-engine.md</code></p>
<h2>Overview</h2>
<p>Hanzo Datastore provides a <strong>unified vector database abstraction</strong> for AI applications — embedding storage, similarity search, and RAG retrieval. Available in Go (<code>datastore-go</code>) and general (<code>datastore</code>). Supports multiple backends (pgvector, Pinecone, Weaviate, Qdrant, Milvus) behind a single interface.</p>
<h3>Why Hanzo Datastore?</h3>
<ul><li><strong>Backend-agnostic</strong>: Swap pgvector for Pinecone without code changes</li><li><strong>Go-native</strong>: High-performance, type-safe Go API</li><li><strong>RAG-ready</strong>: Built for Retrieval-Augmented Generation pipelines</li><li><strong>Metadata filtering</strong>: Rich query filters on document metadata</li><li><strong>Batch operations</strong>: Efficient bulk upsert and query</li></ul>
<h2>When to use</h2>
<ul><li>Building RAG (Retrieval-Augmented Generation) pipelines</li><li>Storing and querying vector embeddings</li><li>Semantic search over documents</li><li>Nearest-neighbor queries with metadata filtering</li><li>Abstracting away vector DB vendor specifics</li></ul>
<h2>Quick reference</h2>
<p>| Item | Value | |------|-------| | Go module | <code>github.com/hanzoai/datastore-go</code> | | General | <code>github.com/hanzoai/datastore</code> | | Backends | pgvector, Pinecone, Weaviate, Qdrant, Milvus |</p>
<h2>Go SDK</h2>
<pre><code class="lang-bash">go get github.com/hanzoai/datastore-go</code></pre>
<h3>Basic Usage</h3>
<pre><code class="lang-go">import ds &quot;github.com/hanzoai/datastore-go&quot;
// Create store with pgvector backend
store, err := ds.New(ds.Config{
Backend: &quot;pgvector&quot;,
DSN: os.Getenv(&quot;DATABASE_URL&quot;),
})
defer store.Close()
// Upsert a document
err = store.Upsert(ctx, ds.Document{
ID: &quot;doc-1&quot;,
Content: &quot;Hanzo AI is a frontier AI company&quot;,
Embedding: embeddingVector, // []float32 from your embedding model
Metadata: map[string]any{&quot;source&quot;: &quot;docs&quot;, &quot;section&quot;: &quot;about&quot;},
})
// Similarity search
results, err := store.Query(ctx, ds.QueryRequest{
Embedding: queryVector,
TopK: 5,
Filter: map[string]any{&quot;source&quot;: &quot;docs&quot;},
})
for _, r := range results {
fmt.Printf(&quot;%.3f: %s\n&quot;, r.Score, r.Content)
}</code></pre>
<h3>Batch Operations</h3>
<pre><code class="lang-go">// Batch upsert
docs := []ds.Document{
{ID: &quot;doc-1&quot;, Content: &quot;First document&quot;, Embedding: vec1},
{ID: &quot;doc-2&quot;, Content: &quot;Second document&quot;, Embedding: vec2},
{ID: &quot;doc-3&quot;, Content: &quot;Third document&quot;, Embedding: vec3},
}
err = store.BatchUpsert(ctx, docs)
// Batch query
queries := []ds.QueryRequest{
{Embedding: q1, TopK: 5},
{Embedding: q2, TopK: 3},
}
results, err := store.BatchQuery(ctx, queries)</code></pre>
<h3>Backend Configuration</h3>
<pre><code class="lang-go">// pgvector (default, uses existing PostgreSQL)
store, _ := ds.New(ds.Config{
Backend: &quot;pgvector&quot;,
DSN: &quot;postgresql://user:pass@postgres:5432/vectors&quot;,
Options: map[string]any{
&quot;table&quot;: &quot;embeddings&quot;,
&quot;dimensions&quot;: 1536,
&quot;index_type&quot;: &quot;hnsw&quot;, // or &quot;ivfflat&quot;
},
})
// Pinecone
store, _ := ds.New(ds.Config{
Backend: &quot;pinecone&quot;,
Options: map[string]any{
&quot;api_key&quot;: os.Getenv(&quot;PINECONE_API_KEY&quot;),
&quot;environment&quot;: &quot;us-east-1-aws&quot;,
&quot;index&quot;: &quot;my-index&quot;,
},
})
// Qdrant
store, _ := ds.New(ds.Config{
Backend: &quot;qdrant&quot;,
Options: map[string]any{
&quot;url&quot;: &quot;http://qdrant:6333&quot;,
&quot;collection&quot;: &quot;documents&quot;,
},
})
// Weaviate
store, _ := ds.New(ds.Config{
Backend: &quot;weaviate&quot;,
Options: map[string]any{
&quot;url&quot;: &quot;http://weaviate:8080&quot;,
&quot;class&quot;: &quot;Document&quot;,
},
})</code></pre>
<h3>RAG Pipeline</h3>
<pre><code class="lang-go">import (
ds &quot;github.com/hanzoai/datastore-go&quot;
&quot;github.com/hanzoai/go-sdk&quot;
)
// Initialize
client := hanzo.NewClient()
store, _ := ds.New(ds.Config{Backend: &quot;pgvector&quot;, DSN: dbURL})
// Index documents
for _, doc := range documents {
// Generate embedding
resp, _ := client.Embeddings.Create(ctx, hanzo.EmbeddingRequest{
Model: &quot;zen-embedding&quot;,
Input: doc.Content,
})
// Store
store.Upsert(ctx, ds.Document{
ID: doc.ID,
Content: doc.Content,
Embedding: resp.Data[0].Embedding,
Metadata: map[string]any{&quot;source&quot;: doc.Source},
})
}
// Query (RAG retrieval step)
queryEmb, _ := client.Embeddings.Create(ctx, hanzo.EmbeddingRequest{
Model: &quot;zen-embedding&quot;,
Input: userQuestion,
})
results, _ := store.Query(ctx, ds.QueryRequest{
Embedding: queryEmb.Data[0].Embedding,
TopK: 5,
})
// Build context for LLM
context := &quot;&quot;
for _, r := range results {
context += r.Content + &quot;\n\n&quot;
}
// Generate answer with context
answer, _ := client.Chat.Completions.Create(ctx, hanzo.ChatRequest{
Model: &quot;zen-70b&quot;,
Messages: []hanzo.Message{
{Role: &quot;system&quot;, Content: &quot;Answer based on this context:\n&quot; + context},
{Role: &quot;user&quot;, Content: userQuestion},
},
})</code></pre>
<h3>Document Interface</h3>
<pre><code class="lang-go">type Document struct {
ID string // Unique identifier
Content string // Original text content
Embedding []float32 // Vector embedding
Metadata map[string]any // Filterable metadata
}
type QueryRequest struct {
Embedding []float32 // Query vector
TopK int // Number of results
Filter map[string]any // Metadata filters
MinScore float32 // Minimum similarity threshold
IncludeContent bool // Include original content in results
}
type QueryResult struct {
ID string
Content string
Score float32 // Similarity score (0-1)
Metadata map[string]any
}</code></pre>
<h2>Related Skills</h2>
<ul><li><code>hanzo/hanzo-database.md</code> - PostgreSQL with pgvector (primary backend)</li><li><code>hanzo/hanzo-search.md</code> - Full-text + vector search (Meilisearch)</li><li><code>hanzo/hanzo-engine.md</code> - Generate embeddings for documents</li><li><code>hanzo/hanzo-orm.md</code> - Go ORM (for non-vector data)</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: vector, embeddings, rag, similarity-search, go <strong>Prerequisites</strong>: Go, embedding concepts, vector search 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-datastore.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>