Installing Letta Desktop

Letta Desktop is currently in beta. For a more stable development experience, we recommend using the cloud ADE with Docker, or Letta Cloud.

For support, join our community Discord server.

Letta Desktop allows you to run the ADE (Agent Development Environment) as a local application. Letta Desktop also bundles a built-in Letta server, so can run Letta Desktop standalone, or you can connect it to a self-hosted Letta server.

Download Letta Desktop

Download Letta Desktop for Mac (Apple Silicon)

Download Letta Desktop for Windows (x64)

Download Letta Desktop for Linux (x64)

Adding LLM backends

The integrations page is only available when using the embedded Letta server. If you are using a self-hosted Letta server, you can add LLM backends by editing the environment variables when you launch your server. See self-hosting for more information.

The Letta server can be connected to various LLM API backends. You can add additional LLM API backends by opening the integrations panel (clicking the icon). When you configure a new integration (by setting the environment variable in the dialog), the Letta server will be restarted to load the new LLM API backend.

You can also edit the environment variable file directly, located at ~/.letta/env.

For this quickstart demo, we’ll add an OpenAI API key (once we enter our key and click confirm, the Letta server will automatically restart):

Configuration Modes

Letta Desktop can run in two primary modes, which can be configured from the settings menu in the app, or by manually editing the ~/.letta/desktop_config.json file.

Embedded server mode

In this mode Letta Desktop runs its own embedded Letta server with a SQLite database. No additional setup is required - just install Letta Desktop and start creating stateful agents!

Configuration

To manually configure embedded mode, create or edit ~/.letta/desktop_config.json:

1 {
2   "version": "1",
3   "databaseConfig": {
4     "type": "embedded",
5     "embeddedType": "sqlite"
6   }
7 }

Self-Hosted server mode (recommended)

Connect Letta Desktop to your own self-hosted Letta server. You can use this mode to connect to a Letta server running locally (e.g. on localhost:8283 via Docker), or to a Letta server running on a remote machine.

Local Server

Remote Server

For a Letta server running locally on your machine:

1 {
2   "version": "1",
3   "databaseConfig": {
4     "type": "local",
5     "url": "http://localhost:8283"
6   }
7 }

Embedded PostgreSQL (deprecated)

This mode is deprecated and will be removed in a future release. See our migration guide if you have existing data in PostgreSQL from Letta Desktop you want to preserve.

Configuration

Migration Guide

For backwards compatibility, you can still run the embedded server with PostgreSQL:

1 {
2   "version": "1",
3   "databaseConfig": {
4     "type": "embedded",
5     "embeddedType": "pgserver"
6   }
7 }

Support

For bug reports and feature requests, contact us on Discord.