Skip to content

Configuration

memsearch uses a layered TOML config system. Most users don't need to configure anything — the defaults work out of the box.

Config Locations (priority low → high)

  1. ~/.memsearch/config.toml — global defaults
  2. <project>/.memsearch.toml — project-level overrides
  3. CLI flags — highest priority

Quick Setup

# Interactive config wizard
memsearch config init

# Or set individual values
memsearch config set embedding.provider onnx
memsearch config set milvus.uri http://localhost:19530

Embedding Provider

Provider Install API Key Notes
onnx (default) pip install memsearch[onnx] No Local, free, ~100MB model download
openai pip install memsearch[openai] OPENAI_API_KEY Best quality
google pip install memsearch[google] GOOGLE_API_KEY Gemini embeddings
voyage pip install memsearch[voyage] VOYAGE_API_KEY High quality
jina pip install memsearch[jina] JINA_API_KEY jina-embeddings-v4, multilingual, long context
mistral pip install memsearch[mistral] MISTRAL_API_KEY EU-based, GDPR-friendly
ollama pip install memsearch[ollama] No Local, any model 
# Switch provider
memsearch config set embedding.provider openai
memsearch index --force   # re-index with new provider

Milvus Backend

Backend Config Notes
Milvus Lite (default) — zero config, single file. Great for getting started: 
# Works out of the box, no setup needed
memsearch config get milvus.uri   # → ~/.memsearch/milvus.db

⭐ Zilliz Cloud (recommended) — fully managed, free tier available. No Docker, no ops. Concurrent access and real-time indexing:

memsearch config set milvus.uri "https://in03-xxx.api.gcp-us-west1.zillizcloud.com"
memsearch config set milvus.token "your-api-key"
Sign up for a free Zilliz Cloud cluster

You can sign up on Zilliz Cloud to get a free cluster and API key.

Sign up and get API key

Self-hosted Milvus Server (Docker) — for advanced users

For multi-user or team environments. Requires Docker. See the official installation guide.

memsearch config set milvus.uri http://localhost:19530

View Current Config

memsearch config list          # show all settings
memsearch config get milvus.uri  # show specific value

Plugin Summarization Models

Plugins keep their existing native/default summarization model unless you set a platform-specific override. These settings do not fall back to llm.model.

memsearch config set plugins.claude-code.summarize.model haiku
memsearch config set plugins.codex.summarize.model gpt-5.1-codex-mini
memsearch config set plugins.opencode.summarize.model anthropic/claude-haiku
memsearch config set plugins.openclaw.summarize.model qwen3-coder

Leave the value empty or unset to preserve the current plugin behavior.

Platform-Specific Config

Each plugin may have additional configuration. See: