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.
Python agentaianthropicclaude-codecompressioncontext-engineeringcontext-windowcursorfastapilangchainllmmcpopenaiprompt-engineeringproxypythonragtoken-optimizationtokenstypescript
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.mdxindex 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.pyindex 97a4ad757..bb86524fa 100644--- a/headroom/memory/backends/direct_mem0.py+++ b/headroom/memory/backends/direct_mem0.py@@ -59,6 +59,7 @@ from typing import Anyfrom headroom.log_safety import describe_exception, safe_idfrom headroom.memory import qdrant_env+from headroom.memory.backends.mem0 import disable_mem0_telemetry_by_defaultfrom headroom.memory.models import Memoryfrom headroom.memory.ports import MemorySearchResultfrom 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 Mem0Memorydiff --git a/headroom/memory/backends/mem0.py b/headroom/memory/backends/mem0.pyindex e45096924..a214b874b 100644--- a/headroom/memory/backends/mem0.py+++ b/headroom/memory/backends/mem0.py@@ -22,6 +22,22 @@ from headroom.memory import qdrant_envfrom headroom.memory.models import Memoryfrom 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")+@dataclassclass 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 Mem0Memoryexcept ImportError:diff --git a/tests/test_memory/test_mem0_telemetry.py b/tests/test_memory/test_mem0_telemetry.pynew file mode 100644index 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"