Remember Me, Refine Me.
How to install reme?
agentscope-ai/reme
$git clone https://github.com/agentscope-ai/remeInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install reme by running `git clone https://github.com/agentscope-ai/reme`, then use it for the current task and follow its documentation at https://github.com/agentscope-ai/reme.
README.md
| 1 | <p align="center"> |
| 2 | <img src="docs/figure/reme_logo.png" alt="ReMe Logo" width="50%"> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <a href="https://pypi.org/project/reme-ai/"><img src="https://img.shields.io/badge/python-3.11+-blue" alt="Python Version"></a> |
| 7 | <a href="https://pypi.org/project/reme-ai/"><img src="https://img.shields.io/pypi/v/reme-ai.svg?logo=pypi" alt="PyPI Version"></a> |
| 8 | <a href="https://pepy.tech/project/reme-ai/"><img src="https://img.shields.io/pypi/dm/reme-ai" alt="PyPI Downloads"></a> |
| 9 | <a href="https://github.com/agentscope-ai/ReMe"><img src="https://img.shields.io/github/commit-activity/m/agentscope-ai/ReMe?style=flat-square" alt="GitHub commit activity"></a> |
| 10 | <a href="./LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-black" alt="License"></a> |
| 11 | <a href="./README.md"><img src="https://img.shields.io/badge/English-Click-yellow" alt="English"></a> |
| 12 | <a href="./README_ZH.md"><img src="https://img.shields.io/badge/简体中文-点击查看-orange" alt="简体中文"></a> |
| 13 | <a href="https://github.com/agentscope-ai/ReMe"><img src="https://img.shields.io/github/stars/agentscope-ai/ReMe?style=social" alt="GitHub Stars"></a> |
| 14 | <a href="https://deepwiki.com/agentscope-ai/ReMe"><img src="https://img.shields.io/badge/DeepWiki-Ask_Devin-navy.svg" alt="DeepWiki"></a> |
| 15 | </p> |
| 16 | |
| 17 | <p align="center"> |
| 18 | <a href="https://trendshift.io/repositories/20528" target="_blank"><img src="https://trendshift.io/api/badge/repositories/20528" alt="agentscope-ai%2FReMe | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> |
| 19 | </p> |
| 20 | |
| 21 | <p align="center"> |
| 22 | <strong>An agent memory layer that turns conversations and resources into readable, editable, searchable Markdown memory.</strong><br> |
| 23 | </p> |
| 24 | |
| 25 | > Previous versions: [0.3.x](https://github.com/agentscope-ai/ReMe/tree/reme_v3) · |
| 26 | > [0.2.x](https://github.com/agentscope-ai/ReMe/tree/v0.2.0.6) · |
| 27 | > [MemoryScope](https://github.com/agentscope-ai/ReMe/tree/memoryscope_branch) |
| 28 | |
| 29 | 🧠 ReMe is a local-first memory layer for **AI agents**. It turns conversations and resources into file-based long-term |
| 30 | memory, then continuously indexes, links, and consolidates that memory for future recall. |
| 31 | |
| 32 | ## ✨ Core Ideas |
| 33 | |
| 34 | - **Memory as File**: Markdown files with frontmatter and wikilinks serve as memory nodes that both users and agents can |
| 35 | read and write directly. |
| 36 | - **Self-evolving knowledge base**: Auto Memory, Auto Resource, and Auto Dream progressively transform conversations and |
| 37 | resources into long-term memories, while automatically building wikilink relationships. |
| 38 | - **Progressive hybrid search**: ReMe combines wikilinks, BM25, and embeddings for hybrid retrieval across keyword |
| 39 | matching, semantic recall, and relationship expansion. |
| 40 | - **Agent-friendly integration**: SKILL.md + CLI integration makes it easy for different agents to read, write, |
| 41 | maintain, and reuse memory. |
| 42 | |
| 43 | <p align="center"> |
| 44 | <img src="docs/figure/design-philosophy.svg" alt="ReMe Design Philosophy" width="92%"> |
| 45 | </p> |
| 46 | |
| 47 | ## 🔭 Use Cases |
| 48 | |
| 49 | - **Personal assistants**: Give personal assistants such as |
| 50 | [QwenPaw](https://github.com/agentscope-ai/QwenPaw), [OpenClaw](https://github.com/openclaw/openclaw), and |
| 51 | [Hermes](https://github.com/nousresearch/hermes-agent) a user-editable long-term memory layer. |
| 52 | - **Coding agents**: Preserve coding style, project background, repository decisions, and workflow |
| 53 | experience across sessions when integrating with coding agents such as [Claude Code](plugins/reme). |
| 54 | - **LLM Wiki**: Turn conversations, notes, and resources into a searchable, traceable, and linked Markdown |
| 55 | knowledge base that both users and agents can maintain. |
| 56 | - **Self-evolving agents**: Support agents that learn from experience by saving successful paths, failed attempts, |
| 57 | reusable procedures, and periodic reflections as memory. |
| 58 | |
| 59 | ## 📰 News |
| 60 | |
| 61 | - [2026.07] - Introduced optional Cookbook workflows, starting with |
| 62 | [Daily Paper](cookbook/daily_paper/README.md) for scheduled paper discovery, agent-assisted PDF analysis, reusable |
| 63 | Markdown notes, and five |
Related
6 picksType
- langchain-mcp-adaptersMake Anthropic Model Context Protocol (MCP) tools compatible with LangChain and LangGraph agents.Jul 2026
- mcporterTypeScript runtime and CLI for connecting to configured Model Context Protocol servers.Jul 2026
- mcp-proxyA MCP server which proxies requests to a remote MCP server over streamable HTTP or SSE.Jul 2026
- mcp-atlassianThe Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification.Jul 2026
- open-webuiOpen WebUIJul 2026
- rulesyncUnified AI rules management CLI tool that generates configuration files for various AI development toolsJul 2026
