# [MemGPT](https://memgpt.ai)

Try out our MemGPT chatbot on Discord! ⭐ NEW: You can now run MemGPT with local LLMs and AutoGen! ⭐ [![Discord](https://img.shields.io/discord/1161736243340640419?label=Discord&logo=discord&logoColor=5865F2&style=flat-square&color=5865F2)](https://discord.gg/9GEQrxmVyE) [![arXiv 2310.08560](https://img.shields.io/badge/arXiv-2310.08560-B31B1B?logo=arxiv&style=flat-square)](https://arxiv.org/abs/2310.08560)

🤖 Create perpetual chatbots with self-editing memory!

🗃️ Chat with your data - talk to your local files or SQL database!

## Quick setup Join Discord and message the MemGPT bot (in the `#memgpt` channel). Then run the following commands (messaged to "MemGPT Bot"): * `/profile` (to create your profile) * `/key` (to enter your OpenAI key) * `/create` (to create a MemGPT chatbot) Make sure your privacy settings on this server are open so that MemGPT Bot can DM you: \ MemGPT → Privacy Settings → Direct Messages set to ON

set DMs settings on MemGPT server to be open in MemGPT so that MemGPT Bot can message you

You can see the full list of available commands when you enter `/` into the message box.

## What is MemGPT? Memory-GPT (or MemGPT in short) is a system that intelligently manages different memory tiers in LLMs in order to effectively provide extended context within the LLM's limited context window. For example, MemGPT knows when to push critical information to a vector database and when to retrieve it later in the chat, enabling perpetual conversations. Learn more about MemGPT in our [paper](https://arxiv.org/abs/2310.08560). ## Running MemGPT locally Install MemGPT: ```sh pip install pymemgpt ``` Add your OpenAI API key to your environment: ```sh export OPENAI_API_KEY=YOUR_API_KEY # on Linux/Mac set OPENAI_API_KEY=YOUR_API_KEY # on Windows $Env:OPENAI_API_KEY = "YOUR_API_KEY" # on Windows (PowerShell) ``` Configure default setting for MemGPT by running: ``` memgpt configure ``` Now, you can run MemGPT with: ```sh memgpt run ``` You can run the following commands in the MemGPT CLI prompt: * `/exit`: Exit the CLI * `/attach`: Attach a loaded data source to the agent * `/save`: Save a checkpoint of the current agent/conversation state * `/dump`: View the current message log (see the contents of main context) * `/dump `: View the last messages (all if is omitted) * `/memory`: Print the current contents of agent memory * `/pop`: Undo the last message in the conversation * `/pop `: Undo the last messages in the conversation. It defaults to 3, which usually is one turn around in the conversation * `/retry`: Pops the last answer and tries to get another one * `/rethink `: Will replace the inner dialog of the last assistant message with the to help shaping the conversation * `/rewrite`: Will replace the last assistant answer with the given text to correct or force the answer * `/heartbeat`: Send a heartbeat system message to the agent * `/memorywarning`: Send a memory warning system message to the agent Once you exit the CLI with `/exit`, you can resume chatting with the same agent by specifying the agent name in `memgpt run --agent `. ## Documentation See full documentation at: https://memgpt.readthedocs.io/ ## Support For issues and feature requests, please [open a GitHub issue](https://github.com/cpacker/MemGPT/issues) or message us on our `#support` channel on [Discord](https://discord.gg/9GEQrxmVyE) ## Datasets Datasets used in our [paper](https://arxiv.org/abs/2310.08560) can be downloaded at [Hugging Face](https://huggingface.co/MemGPT). ## 🚀 Project Roadmap - [x] Release MemGPT Discord bot demo (perpetual chatbot) - [x] Add additional workflows (load SQL/text into MemGPT external context) - [x] Integration tests - [x] Integrate with AutoGen ([discussion](https://github.com/cpacker/MemGPT/discussions/65)) - [x] Add official gpt-3.5-turbo support ([discussion](https://github.com/cpacker/MemGPT/discussions/66)) - [x] CLI UI improvements ([issue](https://github.com/cpacker/MemGPT/issues/11)) - [x] Add support for other LLM backends ([issue](https://github.com/cpacker/MemGPT/issues/18), [discussion](https://github.com/cpacker/MemGPT/discussions/67)) - [ ] Release MemGPT family of open models (eg finetuned Mistral) ([discussion](https://github.com/cpacker/MemGPT/discussions/67))