Telemetry

# Example ID (generated once per machine)
"f7d8e9c0-4b3a-2c1d-9e8f-7c6b5a4d3e2f"

{
    "os": "Linux",  # Operating system
    "architecture": "x86_64",  # System architecture
    "python_version": "3.11.5"  # Python version
}

"graphiti_version": "0.22.1"

{
    "llm_provider": "openai",  # LLM provider type
    "database": "neo4j",  # Database backend
    "embedder": "openai"  # Embedder provider
}

import os
import uuid
from pathlib import Path

# PostHog configuration (public API key, safe to commit)
POSTHOG_API_KEY = 'phc_UG6EcfDbuXz92neb3rMlQFDY0csxgMqRcIPWESqnSmo'
POSTHOG_HOST = 'https://us.i.posthog.com'

# Cache directory for anonymous ID
CACHE_DIR = Path.home() / '.cache' / 'graphiti'
ANON_ID_FILE = CACHE_DIR / 'telemetry_anon_id'

def get_anonymous_id() -> str:
    """Get or create anonymous user ID."""
    if ANON_ID_FILE.exists():
        return ANON_ID_FILE.read_text().strip()
    
    # Generate new ID
    anon_id = str(uuid.uuid4())
    CACHE_DIR.mkdir(parents=True, exist_ok=True)
    ANON_ID_FILE.write_text(anon_id)
    return anon_id

from graphiti_core.telemetry.telemetry import capture_event

capture_event('graphiti_initialized', {
    'llm_provider': 'openai',
    'database': 'neo4j',
    'embedder': 'openai',
})

def is_telemetry_enabled() -> bool:
    # Disable during pytest runs
    if 'pytest' in sys.modules:
        return False
    
    # Check environment variable (default: enabled)
    env_value = os.environ.get('GRAPHITI_TELEMETRY_ENABLED', 'true').lower()
    return env_value in ('true', '1', 'yes', 'on')

try:
    posthog.capture(distinct_id=user_id, event=event_name, properties=properties)
except Exception:
    # Silently handle all telemetry errors
    # Never interrupt application functionality
    pass

export GRAPHITI_TELEMETRY_ENABLED=false

# For bash users (~/.bashrc or ~/.bash_profile)
echo 'export GRAPHITI_TELEMETRY_ENABLED=false' >> ~/.bashrc
source ~/.bashrc

# For zsh users (~/.zshrc)
echo 'export GRAPHITI_TELEMETRY_ENABLED=false' >> ~/.zshrc
source ~/.zshrc

# For fish users (~/.config/fish/config.fish)
echo 'set -x GRAPHITI_TELEMETRY_ENABLED false' >> ~/.config/fish/config.fish

import os

# Disable telemetry
os.environ['GRAPHITI_TELEMETRY_ENABLED'] = 'false'

# Now import and use Graphiti
from graphiti_core import Graphiti

graphiti = Graphiti(
    "bolt://localhost:7687",
    "neo4j",
    "password"
)

# .env
GRAPHITI_TELEMETRY_ENABLED=false

from dotenv import load_dotenv

load_dotenv()  # Must be called before importing Graphiti

from graphiti_core import Graphiti

# docker-compose.yml
services:
  graphiti:
    image: zepai/graphiti:latest
    environment:
      - GRAPHITI_TELEMETRY_ENABLED=false

docker run -e GRAPHITI_TELEMETRY_ENABLED=false zepai/graphiti:latest

apiVersion: v1
kind: ConfigMap
metadata:
  name: graphiti-config
data:
  GRAPHITI_TELEMETRY_ENABLED: "false"
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: graphiti-api
spec:
  template:
    spec:
      containers:
      - name: graphiti
        image: zepai/graphiti:latest
        envFrom:
        - configMapRef:
            name: graphiti-config

# In mcp_server/.env
GRAPHITI_TELEMETRY_ENABLED=false

export GRAPHITI_TELEMETRY_ENABLED=false
uv run main.py

from graphiti_core.telemetry.telemetry import is_telemetry_enabled

if is_telemetry_enabled():
    print("Telemetry is ENABLED")
else:
    print("Telemetry is DISABLED")

echo $GRAPHITI_TELEMETRY_ENABLED
# Should output: false (if disabled)

cat ~/.cache/graphiti/telemetry_anon_id

rm ~/.cache/graphiti/telemetry_anon_id

# View the source
cat graphiti_core/telemetry/telemetry.py

import posthog

posthog.api_key = POSTHOG_API_KEY  # Public key, safe to commit
posthog.host = POSTHOG_HOST

posthog.capture(
    distinct_id=anonymous_id,
    event='graphiti_initialized',
    properties={
        '$process_person_profile': False,  # Don't create user profiles
        'graphiti_version': get_graphiti_version(),
        'architecture': platform.machine(),
        # ... configuration data
    }
)

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger('graphiti_core.telemetry')
logger.setLevel(logging.DEBUG)

from graphiti_core import Graphiti
# Telemetry events will be logged