feat: support local Ollama for embeddings and fact-extraction LLM

[imonroe]

Closes #51.

What

Adds first-class, opt-in config for running mem0's embedder and/or fact-extraction LLM against a local Ollama server — zero per-call cost and no content leaving the host — while keeping anthropic + openai as the default. As the issue notes, _build_config already abstracts the providers, so this is a config + wiring + docs change, not a re-architecture. No change to the single-Memory-per-process invariant.

Changes

• app/config.py — new OLLAMA_BASE_URL setting (default http://localhost:11434). The existing _require_provider_keys validator already enforces a provider's key only when that provider is selected, so ollama needs no ANTHROPIC_API_KEY/OPENAI_API_KEY.
• app/memory.py — _provider_config() is now provider-aware: cloud providers get the API key injected explicitly (as before), while an ollama provider gets mem0's ollama_base_url key (and embedding_dims for the embedder) and no key. Wired through _build_config() for both llm and embedder, so fully-local and mixed cloud/local setups both work.
• .env.example — documented OLLAMA_BASE_URL + a commented-out fully-local provider block.
• docker-compose.yml — commented-out optional bundled ollama service (+ ollama_data volume) for the self-contained stack, with model-pull notes and an optional GPU block.
• docs/USER_GUIDE.md — new "Running fully local with Ollama" section and config-table rows, prominently restating the critical MEM0_EMBED_DIMS-must-match invariant (switching embed models — including cloud↔local — means dropping/recreating the Qdrant collection). docs/DEVELOPER_GUIDE.md — updated the _provider_config internals note.

Config keys (verified against mem0 2.0.2)

{"llm":      {"provider": "ollama", "config": {"model": "llama3.1:8b", "ollama_base_url": "http://localhost:11434"}},
 "embedder": {"provider": "ollama", "config": {"model": "nomic-embed-text", "ollama_base_url": "http://localhost:11434", "embedding_dims": 768}}}

Verification

• ruff check clean; 241 tests pass (pytest -q) against the pinned mem0ai==2.0.2.
• New tests: Ollama config building (fully-local + mixed local-LLM/cloud-embed), OLLAMA_BASE_URL default/override, and — critically — the Ollama config is validated against the real mem0.configs.base.MemoryConfig schema, so a future mem0 rename of ollama_base_url is caught in CI rather than at deploy time.
• Default behavior is unchanged: with no Ollama vars set, the config is byte-for-byte the same anthropic+openai shape as before (existing test_build_config_shape still passes untouched).

🤖 Generated with Claude Code

---

Generated by Claude Code

[Copilot]

Pull request overview

Adds opt-in support for running mem0’s embedder and/or fact-extraction LLM against a local Ollama server, while preserving the existing Anthropic (LLM) + OpenAI (embedder) defaults. This is primarily provider-config wiring plus documentation and tests to ensure the generated mem0 config matches the pinned mem0 schema.

Changes:

• Add OLLAMA_BASE_URL setting and wire ollama_base_url (+ embedding_dims for embeddings) into mem0 provider config.
• Expand docs and .env.example to document fully-local and mixed cloud/local setups, plus a commented optional ollama Docker Compose service.
• Add tests for Ollama config shapes and schema validation against mem0.configs.base.MemoryConfig.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
app/config.py	Adds ollama_base_url setting (default http://localhost:11434).
app/memory.py	Makes provider config provider-aware and wires Ollama base URL + embedding dims into mem0 config.
tests/test_memory.py	Adds tests for Ollama-only and mixed provider config shapes + validates against real mem0 schema.
tests/test_config.py	Adds test coverage for OLLAMA_BASE_URL default/override.
docs/USER_GUIDE.md	Documents Ollama usage, config reference updates, and the embed-dims/Qdrant invariant.
docs/DEVELOPER_GUIDE.md	Updates internal notes about _provider_config() behavior for cloud vs Ollama.
docker-compose.yml	Adds a commented-out optional ollama service and volume notes.
.env.example	Documents Ollama-related env vars and a fully-local example block.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.