# HDC Note Codebook

A hyperdimensional codebook library for indexing private markdown notes.
Free download. Python, CPU-only, MIT license.

## Why
Embedding-based search is slow and memory-hungry on big personal corpora. HDC
(hyperdimensional computing) gives sub-second cleanup retrieval on a CPU with 1–5 KB
per note. We use the same library to drive every retainer client's private assistant.

## Install
```bash
git clone https://github.com/squatch-c-c/hdc-note-codebook
cd hdc-note-codebook
pip install -e .
```

## Use
```bash
codebook index ~/notes --out notes.codebook
codebook ask notes.codebook "what did I write about retainers in March?"
```

## What's in the box (six codebooks)
1. **action-graph** — verbs and outcomes (5/5 cleanup pilot score)
2. **entity** — people, products, projects
3. **topic** — conceptual buckets
4. **time** — rolling temporal index
5. **citation** — quotes, links, sources
6. **mood** — sentiment / voice fingerprint

All six pack into one ~20 MB file per 10K notes. Incremental updates supported.

## Integrations
- Claude Code / Cursor / Continue.dev via the included MCP server.

## License
MIT. Source: `github.com/squatch-c-c/hdc-note-codebook`.

## Want it deployed for your team?
Retainer tiers start at $4,000/mo. The on-prem AI co-pilot pilot ($24K, 14 days)
ships this stack with a private chat UI on your hardware.

[Start a retainer](/services#retainers) · [Book the pilot](/hire?engagement=ai-copilot)