Home

Awesome

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="assets/Letta-logo-RGB_GreyonTransparent_cropped_small.png"> <source media="(prefers-color-scheme: light)" srcset="assets/Letta-logo-RGB_OffBlackonTransparent_cropped_small.png"> <img alt="Letta logo" src="assets/Letta-logo-RGB_GreyonOffBlack_cropped_small.png" width="500"> </picture> </p> <div align="center"> <h1>Letta (previously MemGPT)</h1> <h3>

Homepage // Documentation // Letta Cloud

</h3>

šŸ‘¾ Letta is an open source framework for building stateful LLM applications. You can use Letta to build stateful agents with advanced reasoning capabilities and transparent long-term memory. The Letta framework is white box and model-agnostic.

Discord Twitter Follow arxiv 2310.08560

Apache 2.0 Release GitHub

<a href="https://trendshift.io/repositories/3612" target="_blank"><img src="https://trendshift.io/api/badge/repositories/3612" alt="cpacker%2FMemGPT | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

</div>

[!NOTE] Looking for MemGPT? You're in the right place!

The MemGPT package and Docker image have been renamed to letta to clarify the distinction between MemGPT agents and the API server / runtime that runs LLM agents as services.

You use the Letta framework to create MemGPT agents. Read more about the relationship between MemGPT and Letta here.

āš” Quickstart

The two main ways to install Letta are through pypi (pip) or via Docker:

Step 1 - Install Letta using pip

$ pip install -U letta

Step 2 - Set your environment variables for your chosen LLM / embedding providers

$ export OPENAI_API_KEY=sk-...

For Ollama (see our full documentation for examples of how to set up various providers):

$ export OLLAMA_BASE_URL=http://localhost:11434

Step 3 - Run the Letta CLI

You can create agents and chat with them via the Letta CLI tool (letta run):

$ letta run
šŸ§¬ Creating new agent...
? Select LLM model: letta-free [type=openai] [ip=https://inference.memgpt.ai]
? Select embedding model: letta-free [type=hugging-face] [ip=https://embeddings.memgpt.ai]
->  šŸ¤– Using persona profile: 'sam_pov'
->  šŸ§‘ Using human profile: 'basic'
->  šŸ› ļø  8 tools: send_message, pause_heartbeats, conversation_search, conversation_search_date, archival_memory_insert, archival_memory_search, core_memory_append, core_memory_replace

šŸŽ‰ Created new agent 'InspiringSpinach'

Hit enter to begin (will request first Letta message)

šŸ’­ User engaged. Recognize as Chad. Acknowledge presence and establish connection. Explore interests and engage in meaningful discourse.
šŸ¤– Hello, Chad. It's nice to meet you. I am keen on learning and exploring new ideas and concepts. Is there a specific topic you'd like to discuss today?

> Enter your message: my name is Brad, not Chad...

šŸ’­ A discrepancy in identity. Reflect this change in core memory. Apologize for the oversight, and rectify the error.
āš”šŸ§  [function] updating memory with core_memory_replace
         First name: Chad
        ā†’ First name: Brad
šŸ’­ Apologize for the mistake in recognizing his name, and begin the conversation anew, addressing him by the correct name this time.
šŸ¤– I apologize for the oversight, Brad. Let's restart. It's a pleasure to meet you, Brad. Is there a specific topic you'd like to discuss today?

> Enter your message:

Step 4 - Run the Letta server

You can start the Letta API server with letta server (see the full API reference here):

$ letta server
Initializing database...
Running: uvicorn server:app --host localhost --port 8283
INFO:     Started server process [47750]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://localhost:8283 (Press CTRL+C to quit)

When you start the Letta API server, the ADE (Agent Development Environment) will be available on http://localhost:8283: <img alt="Screenshot of the Letta ADE (Agent Development Environment)" src="assets/letta_ade_screenshot.png" width="1600">

In Letta, all agents are stored/persisted in the same database, so the agents you create in the CLI are accessible via the API and ADE, and vice versa. Check out the quickstart guide on our docs for a tutorial where you create an agent in the Letta CLI and message the same agent via the Letta API.

šŸ¤— How to contribute

Letta is an open source project built by over a hundred contributors. There are many ways to get involved in the Letta OSS project!


Legal notices: By using Letta and related Letta services (such as the Letta endpoint or hosted service), you are agreeing to our privacy policy and terms of service.