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) 25 Aug 2026
[0a21775] feat: competitor parity — peers, dialectic chat, ingestion, temporal, TTL, grep Commit: 0a21775
Date: 2026-08-24
Author: alfirus
feat: competitor parity — peers, dialectic chat, ingestion, temporal, TTL, grep
peers + peer_cards (ws_<id>_peers, _peer_cards), PUT/GET card, POST/GET /peers
chat dialectic (observer/observed, peer_cards + search + representation -> LLM, Honcho peer.chat parity)
ingest upload, grep, temporal, TTL delete, hybrid search blend
config TTL_HOURS, mcp peers/chat/upload tools (13 tools)
View on GitHub
25 Aug 2026
[6621fe2] feat: conclusions/representation + dreamer (768d) + webhooks 25 Aug 2026
[0f7b12a] feat: honcho-inspired hardening + hybrid search + sessions/scopes 25 Aug 2026
[7afc0cb] feat: MCP + Skills + SDKs (Honcho-aligned) 25 Aug 2026
[73c5b21] feat: phases 1-4 — workspace persistence, retrieval, search pagination, brain auto-fetch, SSE, health, rate limit, metrics, retry (768d) 25 Aug 2026
[4ff8f46] fix: workspace isolation, chunking, search dedup/sort, auth bypass, batch workspace_id 25 Aug 2026
[b8e9b1b] docs: add architecture blueprint and README cross-reference 25 Aug 2026
[46f00a9] feat: initial build — semantic memory server with ChromaDB + optional LLM brain 25 Aug 2026
[064c484] Initial commit Commit: 6621fe2
Date: 2026-08-24
Author: alfirus
feat: conclusions/representation + dreamer (768d) + webhooks
ws_<id>_conclusions (same 768d), GET/POST/DELETE /conclusions, GET /representations
dreamer cron (10m, summarize->embed 768d->conclusions)
webhooks in-mem manager, POST/GET /webhooks
View on GitHub
Commit: 0f7b12a
Date: 2026-08-24
Author: alfirus
feat: honcho-inspired hardening + hybrid search + sessions/scopes
metadata: resource name pattern, NUL strip, depth/key limits; message scope/peer_ids
hybrid: BM25 lexical + RRF fusion via HybridSearch, ?hybrid=true
sessions: POST/GET /sessions with peer_ids+scope, SaveSessionMeta/ListSessions (768d marker)
search: wire hybrid flag
View on GitHub
Commit: 7afc0cb
Date: 2026-08-24
Author: alfirus
feat: MCP + Skills + SDKs (Honcho-aligned)
MCP @vectorizer/mcp stdio proxy (10 tools) for Claude/OpenCode/OpenClaw/Hermes
Skills: .agents/skills/vectorizer + skills/vectorizer-
SDKs: @vectorizer/sdk (TS) + vectorizer-ai (Python)
View on GitHub
Commit: 73c5b21
Date: 2026-08-24
Author: alfirus
feat: phases 1-4 — workspace persistence, retrieval, search pagination, brain auto-fetch, SSE, health, rate limit, metrics, retry (768d)
View on GitHub
Commit: 4ff8f46
Date: 2026-08-24
Author: alfirus
fix: workspace isolation, chunking, search dedup/sort, auth bypass, batch workspace_id
store: collection keyed by workspaceID not sessionID
store: GetWorkspaceStats resolves collection ID before count
store: search sorts/dedupes/truncates globally
store: chunkText advances by consumed length
handlers: panic-safe Where extraction, batch requires workspace_id
main: health check auth bypass for /api/v1/health
compose: pin chroma:1.0.0, healthchecks, service_healthy, CHROMA_HOST/PORT
View on GitHub
Commit: b8e9b1b
Date: 2026-08-24
Author: alfirus
docs: add architecture blueprint and README cross-reference
View on GitHub
Commit: 46f00a9
Date: 2026-08-24
Author: alfirus
feat: initial build — semantic memory server with ChromaDB + optional LLM brain
View on GitHub
Commit: 064c484
Date: 2026-08-24
Author: Alfirus Ahmad
Initial commit
View on GitHub