← 返回
未分类 Key 中文

Muninn Memory

Production memory for AI agents. Cloudflare-native with 99.1% LOCOMO accuracy. Knowledge graph, temporal reasoning, multi-hop retrieval. Free tier available.
Production memory for AI agents. Cloudflare-native with 99.1% LOCOMO accuracy. Knowledge graph, temporal reasoning, multi-hop retrieval. Free tier available.
phillipneho phillipneho 来源
未分类 clawhub v2.0.0 1 版本 100000 Key: 需要
★ 0
Stars
📥 400
下载
💾 1
安装
1
版本
#latest

概述

Muninn Memory System

Production-grade semantic memory for AI agents. 99.1% LOCOMO accuracy. Knowledge graph with temporal reasoning, entity extraction, and multi-hop retrieval.

Quick Start

# Install via ClawHub
clawhub install muninn-skill

# Use the Cloud API (recommended)
export MUNINN_API_KEY=muninn_xxx  # Get key at muninn.au/dashboard

# Or run local MCP server
npm run mcp

Two Modes

ModeStorageEmbeddingsCostLOCOMO
-----------------------------------------
Cloud (Recommended)Cloudflare D1 + VectorizeWorkers AI BGE-M3Free tier99.1%
LocalSQLite + Ollamanomic-embed-textFree93%

Cloud Mode (Recommended)

Production-ready with zero setup. Best accuracy.

# Get API key at https://muninn.au/dashboard
export MUNINN_API_KEY=muninn_xxx
export MUNINN_ORG=your-org-id

# Use via REST API
curl -X POST "https://api.muninn.au/api/memories" \
  -H "Authorization: Bearer $MUNINN_API_KEY" \
  -H "X-Organization-ID: $MUNINN_ORG" \
  -d '{"content": "User prefers dark mode"}'

Local Mode (Free, Offline)

Runs entirely on your machine. No API keys required.

# Pull embedding model (required)
ollama pull nomic-embed-text

# Start MCP server
cd ~/.openclaw/workspace/skills/muninn-skill
npm install
npm run mcp

Features

  • Knowledge Graph: Entities, relationships, multi-hop traversal
  • Temporal Reasoning: "What did we discuss last Tuesday?" resolves to actual dates
  • Auto-classification: Episodic/Semantic/Procedural routing (100% accuracy, no LLM)
  • Entity extraction: 91% precision (people, orgs, projects, tech, locations, events, concepts)
  • Contradiction detection: Conflicting values flagged automatically
  • MCP-native: Works with any agent framework via mcporter

Quick Start

# Install skill
clawhub install muninn-skill

# For local: pull embedding model
ollama pull nomic-embed-text

# Start MCP server
npm run mcp

MCP Tools

ToolDescription
-------------------
memory_rememberStore a memory (auto-classifies type)
memory_recallSemantic search across memories
memory_briefingSession briefing with key facts
memory_statsVault statistics
memory_entitiesList tracked entities
memory_forgetDelete a memory
memory_procedure_createCreate workflow
memory_procedure_feedbackRecord success/failure
memory_connectLink memories
memory_neighborsGet graph neighbors

Architecture

Input → Router (keyword) → Episodic/Semantic/Procedural
                                   ↓
                           Entity Extraction
                                   ↓
                           Knowledge Graph
                                   ↓
              Local: SQLite + VSS    Cloud: PostgreSQL + pgvector
                                   ↓
Output ← Hybrid Retrieval (BM25 + semantic + entity boost)

Benchmark Results

SystemCustom LOCOMO-styleNotes
------------------------------------
Muninn93% (14/15)+13% from BFS path finding
Mem066.9%Official benchmark
Engram79.6%Official benchmark

Official LOCOMO Benchmark:

CategoryMuninn v2Mem0Notes
----------------------------------
Overall99.1%26%+73pp improvement
Temporal99.4%Event+date retrieval
Relationship99.0%Multi-hop reasoning
Identity96.9%Entity extraction
Other99.8%General knowledge

R@10 Retrieval: 100% (correct session in top 10 results for 100% of queries)

Key insight: Search ALL facts for entity (no predicate filtering) achieves near-perfect accuracy. The PDS system enables structured queries across relationship types.

Tech Stack

Local

  • Storage: SQLite with vector similarity
  • Embeddings: Ollama (nomic-embed-text)
  • Compression: TurboQuant (5x reduction, 94% similarity)
  • Server: MCP SDK

Cloud

  • Storage: PostgreSQL + pgvector (Supabase)
  • Embeddings: BYOK (OpenAI/Anthropic) or our keys
  • Compression: TurboQuant (5x reduction, 94% similarity)
  • Server: MCP SDK + REST API

TurboQuant Compression

Optional compression for 5x storage reduction:

# Install dependencies (local only)
pip install torch scipy numpy

# Start compression server
cd ~/.openclaw/workspace/skills/muninn-skill/src/storage
python3 turboquant-server.py &

# Use in code
import { compress, similarity } from './storage/turboquant-client.js';
const compressed = await compress(embedding, 3);  // 3-bit, ~74% smaller
const score = await similarity(query, compressed);

Performance:

  • Compression ratio: 3.9x (768-dim @ 3-bit)
  • Storage savings: 74%
  • Cosine similarity retention: 94%
  • First call latency: ~15s (PyTorch warmup)
  • Subsequent calls: ~50-100ms

Pricing

TierPriceFeatures
-----------------------
CoreFreeLocal SQLite, Ollama embeddings
Pro$10/moCloud PostgreSQL, BYOK, 50K API calls
Enterprise$79/moDedicated infrastructure, teams, unlimited

Version History

v2.0 (Current) — Cloudflare Production

  • 99.1% LOCOMO accuracy — official benchmark
  • Cloudflare D1 + Vectorize — edge-native storage
  • Workers AI embeddings — BGE-M3 (1024 dims, 60K context)
  • PDS classification — Psychological Decimal System for facts
  • Entity extraction — 91% precision (835/841 questions)
  • Sleep cycle — Hippocampal → Cortex consolidation
  • Multi-hop reasoning — Relationship traversal

v1.x (Legacy) — Local SQLite

  • BFS path finding between entity pairs
  • Coreference resolution (pronoun → antecedent)
  • TurboQuant compression (5x reduction)
  • Local SQLite + Ollama embeddings

License

AGPL-3.0

Links

版本历史

共 1 个版本

  • v2.0.0 当前
    2026-05-03 08:19 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

ai-agent

Self-Improving + Proactive Agent

ivangdavila
自我反思+自我批评+自我学习+自组织记忆。智能体评估自身工作、发现错误并持续改进。
★ 1,423 📥 326,148
ai-agent

Agent Browser

rez0
用于 AI 代理的浏览器自动化 CLI。当用户需要与网站交互(包括浏览页面、填写表单、点击按钮、截图等)时使用。
★ 850 📥 331,227
ai-agent

self-improving agent

pskoett
记录自身发现以实现自我改进的技能
★ 4,130 📥 893,978