Skip to content

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

fix(privacy): turn off Mem0's PostHog telemetry by default (#4619)

Tejas Choprafe69f3811680
diff --git a/docs/content/docs/installation.mdx b/docs/content/docs/installation.mdx
index 3bbab4056..1b62fbf68 100644
--- a/docs/content/docs/installation.mdx
+++ b/docs/content/docs/installation.mdx
@@ -101,7 +101,7 @@ pip install "headroom-ai[all]"
| `code` | CodeCompressor (tree-sitter AST parsing) | `pip install "headroom-ai[code]"` |
| `memory` | Persistent memory (sqlite-vec, sentence-transformers) — pure-Python default backend, no compiler | `pip install "headroom-ai[memory]"` |
| `vector` | Optional HNSW vector backend (hnswlib) — needs a C++ toolchain; **not in `[all]`** | `pip install "headroom-ai[vector]"` |
-| `memory-stack` | Optional Qdrant + Neo4j memory backend helpers; **not in `[all]`** | `pip install "headroom-ai[memory-stack]"` |
+| `memory-stack` | Optional Qdrant + Neo4j memory backend helpers; **not in `[all]`**. Headroom turns off Mem0's PostHog telemetry by default; set `MEM0_TELEMETRY=True` to allow it | `pip install "headroom-ai[memory-stack]"` |
| `relevance` | fastembed-based relevance scoring (BAAI/bge-small-en-v1.5, ONNX) | `pip install "headroom-ai[relevance]"` |
| `image` | Image compression (Pillow, ONNX runtime, OCR) | `pip install "headroom-ai[image]"` |
| `reports` | HTML/Markdown report generation (Jinja2) | `pip install "headroom-ai[reports]"` |
diff --git a/headroom/memory/backends/direct_mem0.py b/headroom/memory/backends/direct_mem0.py
index 97a4ad757..bb86524fa 100644
--- a/headroom/memory/backends/direct_mem0.py
+++ b/headroom/memory/backends/direct_mem0.py
@@ -59,6 +59,7 @@ from typing import Any
from headroom.log_safety import describe_exception, safe_id
from headroom.memory import qdrant_env
+from headroom.memory.backends.mem0 import disable_mem0_telemetry_by_default
from headroom.memory.models import Memory
from headroom.memory.ports import MemorySearchResult
from headroom.offline import guard_egress
@@ -219,6 +220,7 @@ class DirectMem0Adapter:
self._neo4j_driver = None
# Initialize Mem0 client for fallback path
+ disable_mem0_telemetry_by_default()
try:
from mem0 import Memory as Mem0Memory
diff --git a/headroom/memory/backends/mem0.py b/headroom/memory/backends/mem0.py
index e45096924..a214b874b 100644
--- a/headroom/memory/backends/mem0.py
+++ b/headroom/memory/backends/mem0.py
@@ -22,6 +22,22 @@ from headroom.memory import qdrant_env
from headroom.memory.models import Memory
from headroom.memory.ports import MemoryFilter, VectorFilter, VectorSearchResult
+MEM0_TELEMETRY_ENV = "MEM0_TELEMETRY"
+
+
+def disable_mem0_telemetry_by_default() -> None:
+ """Opt Mem0 out of its PostHog usage telemetry unless the caller chose.
+
+ Mem0 sends ``mem0.init``/``mem0.add``/``mem0.search`` events (config, OS and
+ version fields plus hashed entity ids) to ``us.i.posthog.com`` unless
+ ``MEM0_TELEMETRY`` is false. It reads the variable once, when
+ ``mem0.memory.telemetry`` is imported, so every ``from mem0 import`` in
+ Headroom calls this first. ``setdefault`` keeps an explicit caller value,
+ including ``True`` to allow it. A host that imported mem0 before Headroom
+ has already read the variable and must set it itself.
+ """
+ os.environ.setdefault(MEM0_TELEMETRY_ENV, "False")
+
@dataclass
class Mem0Config:
@@ -121,6 +137,7 @@ class Mem0Backend:
ImportError: If mem0 package is not installed.
"""
if self._client is None:
+ disable_mem0_telemetry_by_default()
try:
from mem0 import Memory as Mem0Memory
except ImportError:
diff --git a/tests/test_memory/test_mem0_telemetry.py b/tests/test_memory/test_mem0_telemetry.py
new file mode 100644
index 000000000..f932ebb26
--- /dev/null
+++ b/tests/test_memory/test_mem0_telemetry.py
@@ -0,0 +1,69 @@
+"""Mem0's PostHog telemetry is off unless the caller turns it on."""
+
+from __future__ import annotations
+
+import os
+import subprocess
+import sys
+import types
+from typing import Any
+from unittest.mock import MagicMock
+
+import pytest
+
+from headroom.memory.backends.mem0 import Mem0Backend, Mem0Config
+
+
+class _FakeMem0(types.ModuleType):
+ """Stand-in ``mem0`` that records MEM0_TELEMETRY when ``Memory`` is imported.
+
+ Real Mem0 reads the variable at that import, so the value seen here is the
+ one it would use.
+ """
+
+ def __init__(self) -> None:
+ super().__init__("mem0")
+ self.telemetry_at_import: str | None = None
+
+ def __getattr__(self, name: str) -> Any:
+ if name != "Memory":
+ raise AttributeError(name)
+ self.telemetry_at_import = os.environ.get("MEM0_TELEMETRY")
+ return MagicMock()
+
+
+async def test_backend_turns_mem0_telemetry_off_before_importing_mem0(monkeypatch) -> None:
+ monkeypatch.delenv("MEM0_TELEMETRY", raising=False)
+ fake = _FakeMem0()
+ monkeypatch.setitem(sys.modules, "mem0", fake)
+
+ await Mem0Backend(Mem0Config(enable_graph=False))._ensure_client()
+
+ assert fake.telemetry_at_import == "False"
+
+
+async def test_caller_choice_of_mem0_telemetry_wins(monkeypatch) -> None:
+ monkeypatch.setenv("MEM0_TELEMETRY", "True")
+ fake = _FakeMem0()
+ monkeypatch.setitem(sys.modules, "mem0", fake)
+
+ await Mem0Backend(Mem0Config(enable_graph=False))._ensure_client()
+
+ assert fake.telemetry_at_import == "True"
+
+
+def test_real_mem0_reads_the_default_as_disabled() -> None:
+ pytest.importorskip("mem0")
+ env = {k: v for k, v in os.environ.items() if k != "MEM0_TELEMETRY"}
+ script = (
+ "from headroom.memory.backends.mem0 import disable_mem0_telemetry_by_default\n"
+ "disable_mem0_telemetry_by_default()\n"
+ "import mem0.memory.telemetry as t\n"
+ "print(t.MEM0_TELEMETRY)\n"
+ )
+ out = subprocess.run(
+ [sys.executable, "-c", script], env=env, capture_output=True, text=True, check=True
+ )
+ assert out.stdout.strip().splitlines()[-1] == "False"