Installation Guide

Fresh

Installation Methods

Desktop App

Step 1: Download

Download Letta Code for your platform from the official website.

Step 2: Install and Launch

Install the application and launch it. Sign in with your Letta account.

Step 3: Configure Model Providers

Navigate to the bottom-left menu to add external API keys for model providers.

CLI Installation

Prerequisites

Requirement	Version
Node.js	v18+
npm	Latest

Install Globally

npm install -g @letta-ai/letta-code

Authenticate

letta

This opens a browser window for OAuth login. Credentials are stored locally after authentication.

Verify Installation

letta --version

Cloud Deployment

Step 1: Install on Remote Machine

SSH into your remote machine and install Letta Code CLI.

Step 2: Start Server

letta server

Step 3: Approve OAuth

The server generates an OAuth URL. Open it in your browser to approve the connection.

Step 4: Connect

Connect from any of these clients:

• chat.letta.com
• Letta Code desktop app

SDK Installation (Programmatic Access)

For building applications on top of Letta Code:

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

See the SDK Overview for programmatic usage.

Troubleshooting

Common Issue: Node.js Version

Letta Code requires Node.js v18 or later. Check your version with node --version and upgrade if needed.

Authentication Issues

If browser-based OAuth fails, ensure no browser extensions are blocking popups. Try a different browser or clear cookies for the Letta auth domain.

Verification Checklist

• [ ] Platform requirements met (Node.js v18+)
• [ ] Letta Code installed successfully
• [ ] Authentication completed
• [ ] letta command responds
• [ ] Model provider configured