Vectorizer — alfirus.my
← ~/projects 2026 · Creator & maintainer
Vectorizer A lightweight, self-hosted semantic memory server for AI agents — stores messages as embeddings in ChromaDB with optional LLM-powered summarization, agentic dialectic chat, and reasoning graphs.
Go ChromaDB Docker gRPC MCP Qwen Embeddings TypeScript SDK Python SDK
Vectorizer — Semantic Memory Server
A lightweight, self-hosted memory server for AI agents. Stores messages as embeddings in ChromaDB with optional LLM-powered summarization and Q&A. Each agent gets isolated memory via workspace namespaces.
Features
Workspace isolation — ws_ collections, no cross-talk between agents
Semantic + hybrid search — vector cosine (HNSW) + BM25 RRF, temporal filters, grep
Peers + peer cards — agent identity management within workspaces
Agentic dialectic chat — observer/observed modes, reasoning levels, SSE streaming, 5 built-in tools
Reasoning graph + deriver — premise edges, BFS reasoning chains, async derivation
Conclusions + surprisal dreamer — offline summarization with surprisal gating
Optional LLM brain — summarization & RAG Q&A via /chat/completions
Auth — API key or JWT with peer scoping
Layered config — env > .env > config.toml > defaults
Docker-ready — one docker compose up (ChromaDB + Qwen embeddings + Vectorizer)
MCP + Skills + SDKs — 13 MCP tools, TypeScript & Python SDKs
Evals — LongMemEval-style recall + reasoning-grounded benchmarks
Architecture
Agent → Vectorizer API → ChromaDB (vectors) + Embedding Service
│
├─ Qwen3-Embedding-4B (1536d MRL)
├─ nomic-embed-text (768d fallback)
└─ text-embedding-3-small (OpenAI)
Tech Stack
Language: Go
Storage: ChromaDB
Embeddings: Qwen3-Embedding-4B (1536d), nomic-embed-text, OpenAI
Communication: REST API, gRPC, MCP
Deployment: Docker Compose
LLM Integration: OpenAI-compatible endpoints (qwen3:8b, gpt-4o-mini, etc.)
news (89) 09 Sept 2026
Merge pull request #1 from alfirus/feat/vault-writeback Date: 2026-09-08T15:06:24Z
New commit by Alfirus Ahmad: "Merge pull request #1 from alfirus/feat/vault-writeback" (eba124d)
09 Sept 2026
feat: daily API usage tracking — answers 'is any agent really using Vectorizer?' 09 Sept 2026
feat: vault writeback — async per-session staging markdown mirror 09 Sept 2026
docs: hybrid ON by default on search/all + MCP, opt-in for single-workspace, honest source labels 09 Sept 2026
hybrid: default-true in MCP bridge + /search/all, widen BM25 window to 400, honest semantic-fallback label 06 Sept 2026
Workspace identity rule: name IS the ID — canonicalize on create, resolve at collection layer 06 Sept 2026
fix: stateless StreamableHTTP (no cross-request sessions, single client) 06 Sept 2026
fix: Dockerfile.mcp installs devDeps for tsc build, prunes after 06 Sept 2026
feat: hosted MCP over StreamableHTTP (loopback + bearer token) + Dockerfile.mcp + compose service 06 Sept 2026
docs: one canonical code workspace per project — never variant names Date: 2026-09-08T10:12:01Z
New commit by alfirus: "feat: daily API usage tracking — answers 'is any agent really using Vectorizer?'" (f7bff0c)
Date: 2026-09-08T08:19:30Z
New commit by alfirus: "feat: vault writeback — async per-session staging markdown mirror" (deea4b7)
Date: 2026-09-08T04:35:07Z
New commit by alfirus: "docs: hybrid ON by default on search/all + MCP, opt-in for single-workspace, honest source labels" (715e505)
Date: 2026-09-08T02:59:24Z
New commit by alfirus: "hybrid: default-true in MCP bridge + /search/all, widen BM25 window to 400, honest semantic-fallback label" (bb07b45)
Date: 2026-09-05T06:18:05Z
New commit by alfirus: "Workspace identity rule: name IS the ID — canonicalize on create, resolve at collection layer" (807760b)
Date: 2026-09-05T03:02:13Z
New commit by alfirus: "fix: stateless StreamableHTTP (no cross-request sessions, single client)" (95e1c6a)
Date: 2026-09-05T02:53:32Z
New commit by alfirus: "fix: Dockerfile.mcp installs devDeps for tsc build, prunes after" (3b9a7f5)
Date: 2026-09-05T02:48:23Z
New commit by alfirus: "feat: hosted MCP over StreamableHTTP (loopback + bearer token) + Dockerfile.mcp + compose service" (7994ac9)
Date: 2026-09-05T02:22:21Z
New commit by alfirus: "docs: one canonical code workspace per project — never variant names" (2ceede0)