Skip to content

Homie4570/memanto

Β 
Β 

MEMANTO Logo

Memanto - Memory that AI Agents Love!

Learn More Join Discord Setup Video

PyPI - Total Downloads License: MIT PyPI Version Twitter / X


What Is MEMANTO?

MEMANTO is a universal memory layer for agentic AI. While LLMs often forget context between sessions, MEMANTO gives your agents long-term memory so they can carry context forward and remember what matters across sessions.

Why MEMANTO Performs

MEMANTO is built for teams that want high-quality agent memory without graph-heavy complexity. It combines immediate semantic availability, low-overhead serverless operation, and strong real-world memory accuracy so you can ship production workflows with a simpler architecture.

  • Zero-cost ingestion latency: No indexing wait or token usage at ingestion, so memories are available for retrieval immediately.
  • Zero storage cost at idle: Serverless architecture scales to zero when not in use.
  • State-of-the-art benchmark performance: Final evaluation results reached 89.8% on LongMemEval and 87.1% on LoCoMo.

πŸ—οΈ Architecture

MEMANTO architecture

πŸ“Ί Setup & Demo

Watch the video

πŸš€ MEMANTO CLI

MEMANTO comes with a powerful, developer-friendly Command Line Interface. You can manage your agent's memories completely from your terminalβ€”no local server required!

You need a Moorcheh API key to use MEMANTO. Create one in the Moorcheh Dashboard.

MEMANTO has native LLM access, so you don't need a separate external model API key for common memory workflows.

1. Install & Configure

pip install memanto

# Setup your environment (prompts for your Moorcheh API key)
memanto

2. Test Agent Memories

# Create and auto-activate an agent session
memanto agent create customer-support

# Store memories with specific semantic types
memanto remember "The user prefers dark mode for the dashboard."
memanto remember "User's timezone is PST."

# Instantly recall relevant context
memanto recall "What mode does the user like?"

# Get grounded AI answers using built-in RAG
memanto answer "Based on the memory, what should the theme be set to?"

Supported Memory Types

instruction, fact, decision, goal, commitment, preference, relationship, context, event, learning, observation, artifact, error

Use memory types to categorize what you store so retrieval is cleaner and more controllable:

  • Save with a specific type: memanto remember "User prefers concise answers" --type preference
  • Filter by type when searching: memanto recall "user communication style" --type preference

Key Features

Capability Commands What it does
System status dashboard memanto status View environment, configuration, server health, active session, and registered agents.
Local REST API + Web UI memanto serve, memanto ui Run the MEMANTO REST API locally and open an interactive browser UI. (Optional for CLI usage).
Agent lifecycle management memanto agent ... Create/list/delete agents, activate/deactivate sessions, and run agent bootstrap for an intelligence snapshot.
Memory capture at scale memanto remember Store single memories with metadata or batch-ingest up to 100 records from JSON.
File upload to memory memanto upload Upload documents (.pdf, .docx, .xlsx, .json, .txt, .csv, .md) directly into an agent's memory namespace β€” content becomes instantly searchable via recall.
Advanced retrieval modes memanto recall Run standard search plus temporal queries (--as-of, --changed-since, --current-only) with filters.
Grounded QA over memory memanto answer Generate RAG answers using retrieved memory context.
Daily intelligence workflows memanto daily-summary, memanto conflicts Generate summaries, detect contradictions, and resolve conflicts interactively.
Session and automation controls memanto session ..., memanto schedule ... Inspect/extend sessions and enable scheduled daily summary runs.
Memory file pipelines memanto memory export, memanto memory sync Export structured memory markdown and sync MEMORY.md into projects.
Configuration inspection memanto config show Inspect API key status, active agent/session, server settings, and schedule time.
Multi-agent ecosystem integration memanto connect ... Connect/remove/list integrations for Claude Code, Codex, Cursor, Windsurf, Antigravity, Gemini CLI, Cline, Continue, OpenCode, Goose, Roo, GitHub Copilot, and Augment (local or global).

Additional setup guides are available at the Moorcheh YouTube channel.


🎯 REST API Endpoints

For programmatic access, MEMANTO exposes a clean, session-based REST API.

Important: MEMANTO does not have a hosted API server yet. To use these endpoints, run your own local server first:

cd memanto

# Start server
memanto serve

# Or run with Docker
docker-compose up -d

By default, call the endpoints on your local server (for example: "http://127.0.0.1:8000").

Agent Management

  • POST /api/v2/agents - Create a new agent namespace
  • GET /api/v2/agents - List all available agents
  • GET /api/v2/agents/{agent_id} - Get metadata for a specific agent
  • DELETE /api/v2/agents/{agent_id} - Delete an agent and all its memories

Session Management

  • POST /api/v2/agents/{agent_id}/activate - Start a session (returns a 6-hour JWT session_token)
  • POST /api/v2/agents/{agent_id}/deactivate - Manually end a session
  • GET /api/v2/session/current - Check the status/validity of the current session
  • POST /api/v2/session/extend - Extend the session expiration time

Memory Operations

  • POST /api/v2/agents/{agent_id}/remember - Store a new memory into the agent's semantic database
  • POST /api/v2/agents/{agent_id}/batch-remember - Batch-store up to 100 memories in one request
  • POST /api/v2/agents/{agent_id}/upload-file - Upload a file (.pdf, .docx, .xlsx, .json, .txt, .csv, .md) β€” content is chunked and made searchable
  • GET /api/v2/agents/{agent_id}/recall - Run an exact semantic search against the agent's memories
  • POST /api/v2/agents/{agent_id}/answer - Generate a grounded RAG answer based on the agent's memories

Authentication Required:

  • Authorization: Bearer {moorcheh_api_key} header
  • X-Session-Token: {session_token} header (for Session & Memory operations)

πŸ€– Why Moorcheh?

Moorcheh.ai - The world's only no-indexing semantic database.

The Revolutionary Difference

Traditional Vector DBs: Minutes of indexing delay, approximate search, stateful architecture

Moorcheh: Instant availability, exact search, serverless/stateless, 80% compute savings

Real Impact

Feature Traditional Moorcheh
Write-to-Search Minutes Instant
Accuracy Approximate Exact
Idle Costs Always running Zero
Free Tier Limited 100K ops/month

πŸ“„ Research & Results

MEMANTO is backed by peer-reviewed research. For benchmark results, methodology, and technical details, see our paper on Hugging Face:

Memanto: Typed Semantic Memory with Information-Theoretic Retrieval for Long-Horizon Agents

🌟 If you find this project useful, please upvote the paper on Hugging Face! It helps the research reach more people in the community.

You can also explore our models and resources on the Moorcheh Hugging Face organization page.

If you use MEMANTO in your research, please cite:

@misc{abtahi2026memantotypedsemanticmemory,
      title={Memanto: Typed Semantic Memory with Information-Theoretic Retrieval for Long-Horizon Agents}, 
      author={Seyed Moein Abtahi and Rasa Rahnema and Hetkumar Patel and Neel Patel and Majid Fekri and Tara Khani},
      year={2026},
      eprint={2604.22085},
      archivePrefix={arXiv},
      primaryClass={cs.AI},
      url={https://arxiv.org/abs/2604.22085}, 
}

πŸ“ž Support & Documentation

Have questions or feedback? We're here to help:


MIT License

About

Memory that AI Agents Love!

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 86.8%
  • HTML 12.9%
  • Dockerfile 0.3%