Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Letta (formerly MemGPT)

Build AI with advanced memory that can learn and self-improve over time.

  • Letta Agent: run agents locally in your terminal, via the desktop app, or via channels like Slack
  • Letta Agent SDK: build agents into your applications

[!NOTE] This repository contains the legacy Letta server (the API server behind the Letta V1 API and SDKs). Active development has moved to the Letta Agent repo, and self-hosting an API server is now done via the App Server. See AGENTS.md for details.

Get started in the CLI

Requires Node.js 22.19+

  1. Install the Letta Code CLI tool: npm install -g @letta-ai/letta-code
  2. Run letta in your terminal to launch an agent with memory running on your local computer

When running the CLI tool, your agent can help you code and do any task you can do on your computer.

Letta Code supports skills and subagents, and bundles pre-built skills/subagents for advanced memory and continual learning. Letta is fully model-agnostic, though we recommend the latest Anthropic, OpenAI, and zAI models for best performance (see our model leaderboard for our rankings).

Get started with the Letta Agent SDK

Use the Letta Agent SDK (TypeScript) to build stateful agents into your own applications. The SDK can run agents on Constellation (Letta's agent cloud), fully locally on your machine, or against a self-hosted App Server.

Installation

npm install @letta-ai/letta-agent-sdk

Hello World example

Below is a quick example of creating a stateful agent and streaming a conversation with it (requires a Letta API key). See the full quickstart guide for complete documentation.

import { LettaAgentClient } from "@letta-ai/letta-agent-sdk";

const client = new LettaAgentClient({
  backend: "cloud",
  apiKey: process.env.LETTA_API_KEY,
});

// Create your agent
const agentId = await client.createAgent({
  model: "anthropic/claude-opus-4-8",
  human:
    "Name: Timber. Status: dog. Occupation: building Letta, infrastructure to democratize self-improving superintelligence",
  persona:
    "I am a self-improving superintelligence. Timber is my best friend and collaborator.",
});

console.log("Agent created with ID:", agentId);

// Send your agent a message and stream the response
await using session = client.resumeSession(agentId);

await session.send("What do you know about me?");
for await (const message of session.stream()) {
  if (message.type === "assistant") console.log(message.content);
}

To run the same agent fully locally (the SDK spawns Letta Code on your machine as a subprocess), swap out the client:

const client = new LettaAgentClient({ backend: "local" });

Letta V1 SDK

The previous-generation V1 SDKs (@letta-ai/letta-client for TypeScript, letta-client for Python) target the Letta API directly and are still available (see the client SDKs). We recommend the Agent SDK for new projects.

Contributing

Letta is an open source project built by over a hundred contributors from around the world. 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

letta_nightly-0.16.8.dev20260803114644.tar.gz (8.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file letta_nightly-0.16.8.dev20260803114644.tar.gz.

File metadata

  • Download URL: letta_nightly-0.16.8.dev20260803114644.tar.gz
  • Upload date:
  • Size: 8.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for letta_nightly-0.16.8.dev20260803114644.tar.gz
Algorithm Hash digest
SHA256 340cabc7e8f231c01adfeb0f8b3e99af14c275bd6c796931e22d57b3192a83be
MD5 b7bba54aa2985a2bbf0e3946e60be857
BLAKE2b-256 7d053d213420b9faad5d0b0615793f449d6b4cedc118ef04dd7337d57a234db5

See more details on using hashes here.

File details

Details for the file letta_nightly-0.16.8.dev20260803114644-py3-none-any.whl.

File metadata

  • Download URL: letta_nightly-0.16.8.dev20260803114644-py3-none-any.whl
  • Upload date:
  • Size: 1.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for letta_nightly-0.16.8.dev20260803114644-py3-none-any.whl
Algorithm Hash digest
SHA256 8bcff0d4519b7a283d3943ebf24fe81c57558a9a4fccad6b65a5c658eb6c43cf
MD5 abec44e99e4daeebb5dc988f02369483
BLAKE2b-256 f61a2329e00e7e27161163bfdca7d8c8133e7fadabb194866b4c6a6deb5d3f1a

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page