orbitalo/homelab-brain
1
0
Fork 0
Code Issues 89 Pull requests Projects Releases Packages Wiki Activity Actions
homelab-brain/infrastructure/OPENMEMORY.md

3.9 KiB
Raw Blame History

OpenMemory (mem0)

Selbst-gehosteter Memory-Store mit MCP-Schnittstelle. Wird u. a. von Cursor und Jervais/Hermes als persistentes Gedaechtnis genutzt.

Deployment

  • Host: CT122 auf pve-hetzner (Tailscale-Gateway root@100.88.230.59), interne IP 10.10.10.122.
  • Container: Docker Compose unter /root/mem0/openmemory/ (docker-compose.yml):
    • openmemory-openmemory-mcp-1 (mem0/openmemory-mcp) — API/MCP auf Port 8765, uvicorn main:app --reload --workers 4.
    • openmemory-mem0_store-1 (qdrant/qdrant) — Vektor-Store, Collection openmemory.
    • openmemory-openmemory-ui-1 (mem0/openmemory-ui) — Dashboard auf Port 3000.
  • App-Quellcode (bind-mount): Host /root/mem0/openmemory/api → Container /usr/src/openmemory.
  • Aktive Konfiguration: NICHT config.json, sondern DB-Tabelle configs (key main) in /usr/src/openmemory/openmemory.db. LLM = gpt-4o-mini via OpenRouter (OPENAI_BASE_URL=https://openrouter.ai/api/v1), Embedder text-embedding-3-small.
  • Zugang vom Cursor-Host: SSH-Tunnel openmemory-tunnel.service (autossh) leitet localhost:8765 → 10.10.10.122:8765. MCP-URL in mcp.json: http://localhost:8765/mcp/cursor/sse/orbitalo.
  • Logs: docker logs openmemory-openmemory-mcp-1 (json-file, keine Rotation konfiguriert).

Hotfix — 2026-05-31

Behob zwei Fehlfunktionen.

Symptome

  1. list_memories lieferte hart: Error getting memories: fromisoformat: argument must be str.
  2. add_memories mit laengeren Texten gab still {"results": []} zurueck (nicht gespeichert), ohne sichtbaren Client-Fehler.

Root Causes

  1. Gemischte Timestamp-Typen in qdrant. 274 von 663 Punkten hatten hash und created_at als Integer (alte Records einer frueheren mem0-Version), neuere als String/ISO.
    • mem0.memory.main._normalize_iso_timestamp_to_utc() fing nur ValueError; bei int wirft datetime.fromisoformat() ein TypeError → get_all/list_memories crasht komplett.
    • Zusaetzlich verlangt das Pydantic-Modell MemoryItem Strings fuer hash/created_at → ValidationError bei int.
  2. Truncation des Extraktor-LLM-JSON. max_tokens: 2000 zu klein; beim Update-Memory-Schritt (Prompt enthaelt alle bestehenden Memories) wurde das JSON abgeschnitten → Invalid JSON response → leeres results.
    • Hinweis: Leeres results kann AUCH legitim sein (LLM-Dedup → event: NONE/NOOP). Nur das abgeschnittene JSON ist der Bug.

Fixes (angewendet + verifiziert)

  1. qdrant-Daten normalisiert: 274 Records, hash int→str, created_at/updated_at epoch-int→ISO-UTC. Backup: api/qdrant_intfix_backup-20260531.json.
  2. mem0-Library tolerant: site-packages/mem0/memory/main.py except ValueError: → except (ValueError, TypeError):. Backup .bak-tsfix-20260531 (NICHT rebuild-fest).
  3. Durabler Monkeypatch (rebuild-fest): in api/main.py nach den Imports — ueberschreibt _normalize_iso_timestamp_to_utc so, dass Nicht-String-Werte unveraendert durchgereicht werden. Backup api/main.py.bak-tsfix-20260531.
  4. max_tokens erhoeht: DB-Config configs.main → mem0.llm.config.max_tokens 2000 → 8000. Backup api/config_main.bak-20260531.json.

Verifikation

  • _normalize_iso_timestamp_to_utc(1774205916) gibt int zurueck statt Crash; ISO weiterhin korrekt.
  • list_memories() liefert JSON-Array (100), 0 verbleibende int-Records.
  • Langer add_memories → gueltiges JSON, event: ADD (Dedup korrekt NONE/NOOP).
  • Live ueber Cursor-MCP (nach Client-Reload) beide Tools ok.

Nach Container-Rebuild beachten

  • Persistent: Fix 1 (qdrant-Daten), Fix 3 (Monkeypatch in main.py), Fix 4 (DB-Config).
  • Verloren bei Image-Rebuild: Fix 2 (site-packages) — durch Fix 3 abgedeckt.
  • Container-Neustart invalidiert MCP-Sessions → Clients muessen neu initialisieren (-32602 = request before initialization). In Cursor: MCP openmemory toggeln oder Fenster neu laden.