Chroma (local vector index)
Role in Ship: powers POST /search in the bundled FastAPI service — embeddings over documentation/, prompts/, and README.md, persisted under backend/.chroma/.
Operator notes
- Requires
OPENAI_API_KEYon the server for embedding generation; index rebuilds when content fingerprints change (or whenFORCE_REINDEX=true). - Not a multi-tenant hosted vector DB — local-first for methodology search on a laptop or single VM.
Read next
- Backend API —
/search,/fetch,/feedback,/patterns(from the Ship repo usenpm run ship -- docs …andnpm run ship -- patterns …). - Ship CLI:
ship docs search …from the repo root (see rootpackage.jsonscriptship).