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.

Metadata

Release files for letta-nightly 0.16.8.dev20260727114426

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for letta-nightly 0.16.8.dev20260727114426
File Size Uploaded Provenance Actions
letta_nightly-0.16.8.dev20260727114426.tar.gz 8.2 MB Without provenance Details for letta_nightly-0.16.8.dev20260727114426.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for letta-nightly 0.16.8.dev20260727114426
File Interpreter ABI Platform Actions
letta_nightly-0.16.8.dev20260727114426-py3-none-any.whl Python 3 none any Details for letta_nightly-0.16.8.dev20260727114426-py3-none-any.whl

Total release size: 9.8 MB

Release files / letta_nightly-0.16.8.dev20260727114426.tar.gz

Download URL letta_nightly-0.16.8.dev20260727114426.tar.gz
Size 8.2 MB
Tags Source
SHA-256 checksum
How to use checksums
55f8a9f625fd05f0f532913f63a851597babd9f179e8e0131153b579d738b50f
BLAKE2b-256 checksum
How to use checksums
fcc090d8a6d45df9284d076f322482dd1545b9dee1dd7c3ff9c9f03186ae1e72
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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}

Release files / letta_nightly-0.16.8.dev20260727114426-py3-none-any.whl

Download URL letta_nightly-0.16.8.dev20260727114426-py3-none-any.whl
Size 1.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
65c6546ced3ae9b8e10b246b1b8f8dd116ea303f457a2cc3fc95fbc36f0e91be
BLAKE2b-256 checksum
How to use checksums
52e062f074d3fba09978bfe2760c6be7c4bf284341008ebcb363f558222a0204
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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}

Security for letta-nightly 0.16.8.dev20260727114426

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page