docs: add per-purpose inference env vars to deploy config

Exposes MEM0_LLM_BASE_URL, MEM0_LLM_API_KEY, MEM0_EMBED_BASE_URL,
MEM0_EMBED_API_KEY, MEM0_GRAPH_LLM_BASE_URL, MEM0_GRAPH_LLM_API_KEY,
and MEM0_GRAPH_EXTRACTION_STRATEGY across all 4 compose files,
.env.example, and README.

All vars are optional and fall back to OPENAI_BASE_URL / OPENAI_API_KEY.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Thomas Tupper

.env.example

@@ -9,11 +9,24 @@ OLLAMA_CHAT_MODEL=llama3.1:8b
 INFER_API_KEY=
 
 # store runtime (canonical contract)
-# Internal default for one-node compose is service name `infer`.
+# Shared defaults — used as fallback when per-purpose vars are not set.
 OPENAI_BASE_URL=http://infer:8081/v1
 OPENAI_API_KEY=
+
+# Per-purpose inference config.
+# Each purpose (main LLM, embedder, graph LLM) can target a different endpoint.
+# Falls back to shared OPENAI_BASE_URL / OPENAI_API_KEY when not set.
+# This allows e.g. local inference for the main LLM with cloud for embeddings.
+
+# Main LLM (fact extraction + memory decisions)
 MEM0_LLM_MODEL=gpt-4.1-nano
+# MEM0_LLM_BASE_URL=        # falls back to OPENAI_BASE_URL
+# MEM0_LLM_API_KEY=          # falls back to OPENAI_API_KEY
+
+# Embedder — CANNOT change model after the collection is created
 MEM0_EMBED_MODEL=text-embedding-3-small
+# MEM0_EMBED_BASE_URL=       # falls back to OPENAI_BASE_URL
+# MEM0_EMBED_API_KEY=        # falls back to OPENAI_API_KEY
 
 # Qdrant config
 # Prefer QDRANT_URL when supported by the service runtime.
@@ -38,3 +51,6 @@ NEO4J_URL=bolt://neo4j:7687
 NEO4J_USERNAME=neo4j
 NEO4J_PASSWORD=changeme
 MEM0_GRAPH_LLM_MODEL=gpt-4.1-mini
+# MEM0_GRAPH_LLM_BASE_URL=   # falls back to OPENAI_BASE_URL
+# MEM0_GRAPH_LLM_API_KEY=    # falls back to OPENAI_API_KEY
+# MEM0_GRAPH_EXTRACTION_STRATEGY=tool_calling  # or "json_prompting" for models without tool support

README.md

@@ -97,6 +97,22 @@ The `.env` file configures image tags, model names, and provider keys.
 | `QDRANT_API_KEY` | Qdrant auth key (optional) | store runtime | `` |
 | `QDRANT_COLLECTION` | Collection name for memory vectors | `store` service | `foxmemory` |
 
+### Per-purpose inference (optional)
+
+Each inference purpose can target a different endpoint. All fall back to `OPENAI_BASE_URL` / `OPENAI_API_KEY` when not set — existing deployments are unaffected.
+
+| Variable | Purpose | Fallback | Example |
+|---|---|---|---|
+| `MEM0_LLM_BASE_URL` | Main LLM endpoint | `OPENAI_BASE_URL` | `http://exo:8000/v1` |
+| `MEM0_LLM_API_KEY` | Main LLM API key | `OPENAI_API_KEY` | `not-needed` |
+| `MEM0_EMBED_BASE_URL` | Embedder endpoint | `OPENAI_BASE_URL` | `https://api.openai.com/v1` |
+| `MEM0_EMBED_API_KEY` | Embedder API key | `OPENAI_API_KEY` | `sk-...` |
+| `MEM0_GRAPH_LLM_BASE_URL` | Graph LLM endpoint | `OPENAI_BASE_URL` | `https://api.openai.com/v1` |
+| `MEM0_GRAPH_LLM_API_KEY` | Graph LLM API key | `OPENAI_API_KEY` | `sk-...` |
+| `MEM0_GRAPH_EXTRACTION_STRATEGY` | Graph extraction method | `tool_calling` | `json_prompting` |
+
+`MEM0_GRAPH_EXTRACTION_STRATEGY` controls how entities and relationships are extracted from text. Use `tool_calling` (default) for models that support OpenAI-style function calling. Use `json_prompting` for models that don't (e.g. small local models served via EXO).
+
 Backward-compatible variables still present in some scripts/builds:
 
 - `QDRANT_HOST`

compose.external.yml

@@ -18,7 +18,11 @@ services:
       - OPENAI_BASE_URL=${OPENAI_BASE_URL}
       - OPENAI_API_KEY=${OPENAI_API_KEY}
       - MEM0_LLM_MODEL=${MEM0_LLM_MODEL}
+      - MEM0_LLM_BASE_URL=${MEM0_LLM_BASE_URL:-}
+      - MEM0_LLM_API_KEY=${MEM0_LLM_API_KEY:-}
       - MEM0_EMBED_MODEL=${MEM0_EMBED_MODEL}
+      - MEM0_EMBED_BASE_URL=${MEM0_EMBED_BASE_URL:-}
+      - MEM0_EMBED_API_KEY=${MEM0_EMBED_API_KEY:-}
       - QDRANT_HOST=qdrant
       - QDRANT_PORT=6333
       - QDRANT_COLLECTION=${QDRANT_COLLECTION}

compose.graph.yml

@@ -35,7 +35,11 @@ services:
       OPENAI_BASE_URL: ${OPENAI_BASE_URL}
       OPENAI_API_KEY: ${OPENAI_API_KEY}
       MEM0_LLM_MODEL: ${MEM0_LLM_MODEL:-gpt-4.1-nano}
+      MEM0_LLM_BASE_URL: ${MEM0_LLM_BASE_URL:-}
+      MEM0_LLM_API_KEY: ${MEM0_LLM_API_KEY:-}
       MEM0_EMBED_MODEL: ${MEM0_EMBED_MODEL:-text-embedding-3-small}
+      MEM0_EMBED_BASE_URL: ${MEM0_EMBED_BASE_URL:-}
+      MEM0_EMBED_API_KEY: ${MEM0_EMBED_API_KEY:-}
       QDRANT_HOST: qdrant
       QDRANT_PORT: "6333"
       QDRANT_COLLECTION: ${QDRANT_COLLECTION:-foxmemory}
@@ -46,6 +50,9 @@ services:
       NEO4J_USERNAME: ${NEO4J_USERNAME:-neo4j}
       NEO4J_PASSWORD: ${NEO4J_PASSWORD:-}
       MEM0_GRAPH_LLM_MODEL: ${MEM0_GRAPH_LLM_MODEL:-gpt-4.1-mini}
+      MEM0_GRAPH_LLM_BASE_URL: ${MEM0_GRAPH_LLM_BASE_URL:-}
+      MEM0_GRAPH_LLM_API_KEY: ${MEM0_GRAPH_LLM_API_KEY:-}
+      MEM0_GRAPH_EXTRACTION_STRATEGY: ${MEM0_GRAPH_EXTRACTION_STRATEGY:-}
     volumes:
       - foxmemory_analytics_data:/data
     depends_on:

compose.one.yml

@@ -33,7 +33,11 @@ services:
       - OPENAI_BASE_URL=${OPENAI_BASE_URL}
       - OPENAI_API_KEY=${INFER_API_KEY}
       - MEM0_LLM_MODEL=${MEM0_LLM_MODEL}
+      - MEM0_LLM_BASE_URL=${MEM0_LLM_BASE_URL:-}
+      - MEM0_LLM_API_KEY=${MEM0_LLM_API_KEY:-}
       - MEM0_EMBED_MODEL=${MEM0_EMBED_MODEL}
+      - MEM0_EMBED_BASE_URL=${MEM0_EMBED_BASE_URL:-}
+      - MEM0_EMBED_API_KEY=${MEM0_EMBED_API_KEY:-}
       - QDRANT_HOST=127.0.0.1
       - QDRANT_PORT=6333
       - QDRANT_COLLECTION=${QDRANT_COLLECTION}
@@ -45,6 +49,9 @@ services:
       - NEO4J_USERNAME=${NEO4J_USERNAME:-neo4j}
       - NEO4J_PASSWORD=${NEO4J_PASSWORD:-}
       - MEM0_GRAPH_LLM_MODEL=${MEM0_GRAPH_LLM_MODEL:-gpt-4.1-mini}
+      - MEM0_GRAPH_LLM_BASE_URL=${MEM0_GRAPH_LLM_BASE_URL:-}
+      - MEM0_GRAPH_LLM_API_KEY=${MEM0_GRAPH_LLM_API_KEY:-}
+      - MEM0_GRAPH_EXTRACTION_STRATEGY=${MEM0_GRAPH_EXTRACTION_STRATEGY:-}
     volumes:
       - foxmemory_store_data:/qdrant/storage
     depends_on:

compose.split.yml

@@ -31,7 +31,11 @@ services:
       - OPENAI_BASE_URL=${OPENAI_BASE_URL}
       - OPENAI_API_KEY=${OPENAI_API_KEY}
       - MEM0_LLM_MODEL=${MEM0_LLM_MODEL}
+      - MEM0_LLM_BASE_URL=${MEM0_LLM_BASE_URL:-}
+      - MEM0_LLM_API_KEY=${MEM0_LLM_API_KEY:-}
       - MEM0_EMBED_MODEL=${MEM0_EMBED_MODEL}
+      - MEM0_EMBED_BASE_URL=${MEM0_EMBED_BASE_URL:-}
+      - MEM0_EMBED_API_KEY=${MEM0_EMBED_API_KEY:-}
       - QDRANT_HOST=127.0.0.1
       - QDRANT_PORT=6333
       - QDRANT_COLLECTION=${QDRANT_COLLECTION}
@@ -43,6 +47,9 @@ services:
       - NEO4J_USERNAME=${NEO4J_USERNAME:-neo4j}
       - NEO4J_PASSWORD=${NEO4J_PASSWORD:-}
       - MEM0_GRAPH_LLM_MODEL=${MEM0_GRAPH_LLM_MODEL:-gpt-4.1-mini}
+      - MEM0_GRAPH_LLM_BASE_URL=${MEM0_GRAPH_LLM_BASE_URL:-}
+      - MEM0_GRAPH_LLM_API_KEY=${MEM0_GRAPH_LLM_API_KEY:-}
+      - MEM0_GRAPH_EXTRACTION_STRATEGY=${MEM0_GRAPH_EXTRACTION_STRATEGY:-}
     volumes:
       - foxmemory_store_data:/qdrant/storage
     depends_on: