概要

コンテキストウィンドウをRAM、それ以外をディスクとみなし、何を読み込み何を退避するかをエージェント自身に判断させます。この枠組みにより、無期限に動き続けるエージェントが扱える対象になります。既存スタックにメモリライブラリを後付けするより、思想への踏み込みが大きい選択です。

Lettaで何ができますか？

手元でメモリ付きエージェントを起動 — npm install -g @letta-ai/letta-codeでCLIを導入し、lettaコマンドを実行すると自分のマシン上でメモリを持つエージェントが起動します（Node.js 22.19以上が必要）。エージェントはデスクトップアプリやSlackなどのチャネル経由でも実行できます。
自作アプリに状態付きエージェントを組み込む — TypeScript版のAgent SDKではnpm install @letta-ai/letta-agent-sdkを導入し、createAgentにモデル名とhuman、personaを渡してエージェントを作成し、resumeSessionとsession.stream()で応答を逐次受け取ります。モデルはanthropic/claude-opus-4-8のような文字列で指定し、特定のプロバイダには依存しません。
実行場所をbackendの指定で切り替え — 同じコードのままLettaのエージェントクラウドであるConstellation、自前のApp Server、そしてbackendにlocalを指定してLetta Codeをサブプロセス起動する完全ローカル実行を選べます。
既存のV1 SDKはそのまま使える — 旧世代のV1 SDKであるTypeScript向けの@letta-ai/letta-clientとPython向けのletta-clientは、現在もLetta APIを直接呼び出せます。READMEが新規プロジェクトに勧めているのはAgent SDKのほうです。
新規採用はletta-code側から — 本リポジトリはV1 APIを提供する旧サーバーであり、開発の主体はletta-ai/letta-codeへ移っています。APIサーバーを自前で運用する場合はApp Serverを使います。

ドキュメント

letta-ai/letta のREADMEより転載（Apache-2.0）。原文を読む ↗

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+

Install the Letta Code CLI tool: npm install -g @letta-ai/letta-code
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.