convez.ai
MCP ServerAutomaçãoAvançado
lelin1997

MiniMem

lelin1997/minimem

Memória persistente estruturada para agentes de IA com Dream Engine

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema de memória centralizado para agentes de IA com arquitetura em pirâmide de 4 camadas (L1-L4), Dream Engine para síntese noturna de conhecimento e suporte nativo ao protocolo MCP. Oferece recuperação vetorial, controle de versão e perfis de agente estruturados em Markdown.

Instalação

$npx convez-ai lelin1997/minimem

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Agentes de IA que precisam de memória persistente e estruturada entre sessões
  • Sistemas que precisam sintetizar experiências brutas em conhecimento estruturado
  • Aplicações multi-tenant com isolamento de domínio e controle de permissões

Veredito

MiniMem é uma solução sofisticada e bem arquitetada para persistência de memória em agentes de IA, com inovações genuínas no Dream Engine e compilação de conhecimento. Recomendado para quem constrói sistemas complexos de agentes que precisam evoluir conhecimento ao longo do tempo, mas exige expertise em TypeScript e compreensão profunda de arquiteturas de memória.

README

A tradução para o português deste README ainda está na fila.

🧠 MiniMem

A Personal Unified Memory System — The Central Memory Service for AI Agents

MiniMem gives AI agents persistent, structured, and retrievable memory. Built on a L1→L4 four-layer memory pyramid, it uses a Dream Engine to automatically distill raw experiences into structured knowledge during nightly sleep cycles.


✨ Features

  • 🧩 L1→L4 Memory Pyramid — From raw experiences to mental models, layered compression with increasing abstraction
  • 🌙 Dream Engine — 4-phase nightly pipeline: Audit → Compile (Karpathy Compile) → Dream → Cleanup
  • 📝 Karpathy Compile — LLM-driven knowledge synthesis: generates bi-directionally linked knowledge pages with version history
  • 🔗 MCP Protocol — Native Model Context Protocol support (stdio + Streamable HTTP)
  • 🧭 Vector Retrieval — In-memory HNSW index + FTS5 full-text search + conditional indexing
  • 📦 Surface Files — Agent-readable Markdown files (me/soul/work/social/life profiles)
  • 💡 Inspiration Engine — Cross-domain memory collision for creative sparks
  • 🔄 Version Control — Snapshots + branching + rollback for safe memory evolution
  • 🌡️ Temperature Decay — Ebbinghaus forgetting curve + tiered compression
  • 🔐 Multi-tenant — JWT auth + client permission levels + domain isolation

🏗️ Architecture

┌─────────────────────────────────────────────────────┐
│                    MiniMem                           │
│                                                     │
│  ┌─────────┐  ┌──────────┐  ┌──────────┐  ┌──────┐ │
│  │  L1     │→│  L2      │→│  L3      │→│  L4  │ │
│  │  Experiences │  Facts  │  │ Observations/ │ Mental│ │
│  │         │  │ (triples)│  │ Knowl.Pages│  │Models │ │
│  └─────────┘  └──────────┘  └──────────┘  └──────┘ │
│                                                     │
│  ┌─────────────────────────────────────────────┐    │
│  │           Dream Engine (nightly)             │    │
│  │  P1: Audit → P2: Compile →                  │    │
│  │  P3: Dream  → P4: Cleanup                   │    │
│  └─────────────────────────────────────────────┘    │
│                                                     │
│  ┌──────────┐  ┌──────────┐  ┌──────────────────┐  │
│  │ REST API │  │ MCP Srv  │  │ MiniMem Console  │  │
│  │ (Hono)   │  │ (stdio/  │  │ (React SPA)      │  │
│  │          │  │  HTTP)   │  │                  │  │
│  └──────────┘  └──────────┘  └──────────────────┘  │
└─────────────────────────────────────────────────────┘

🚀 Quick Start

Prerequisites

  • Node.js >= 20.0.0
  • pnpm (recommended)

Install & Run

git clone https://github.com/lelin1997/minimem.git
cd minimem/minimem

# Install dependencies
pnpm install

# Configure
cp .env.example .env
# Edit .env with your LLM API key and JWT secret

# Build & start
pnpm build
pnpm start

Run Modes

# REST API mode (default, port 6677)
pnpm start

# MCP Server mode (stdio — for Claude Desktop, etc.)
node dist/index.js --mcp

# MCP HTTP mode (port 6678)
MINIMEM_MCP_PORT=6678 node dist/index.js --mcp-http

Claude Desktop Integration

{
  "mcpServers": {
    "minimem": {
      "command": "node",
      "args": ["/path/to/minimem/dist/index.js", "--mcp"]
    }
  }
}

🎮 Console

MiniMem Console is a standalone web dashboard providing:

  • 📊 Dashboard — system overview & stats
  • 🧠 Memory Browser — search, browse, edit memories
  • 📄 Knowledge Pages — view Karpathy Compile results
  • 👤 Owner Profile — manage your agent's identity
  • 🔄 Pipeline Editor — visual data pipeline orchestration
cd minimem-console
pnpm install
cp .env.example .env
pnpm dev

📁 Project Structure

minimem/
├── minimem/                  # Core engine (31.5K lines)
│   ├── src/
│   │   ├── core/             # Memory processing core
│   │   ├── gateway/          # REST API + MCP Server
│   │   ├── llm/              # LLM client (multi-model tiers)
│   │   ├── modules/dream/    # Dream Engine
│   │   ├── recall/           # Retrieval & ranking
│   │   ├── store/            # Database & indexes
│   │   ├── surface/          # Surface Files
│   │   └── version/          # Version control
│   └── tests/                # 44 test files
└── minimem-console/           # Web management console
    ├── src/                   # React frontend
    └── server/                # Console backend

🧪 Tests

cd minimem
pnpm test          # Run all tests
pnpm test:watch    # Watch mode
pnpm typecheck     # Type checking

📡 API

MCP tools exposed via protocol: add_memory, search_memory, get_relevant_context, recall_about, list_memories, generate_daily_summary, trigger_dream, and more.


📄 License

MIT © MiniMem Contributors


🙏 Acknowledgements

Ver o original no GitHub

Bom para

Relacionados