Desktop > Embedded Server: A JavaScript error occurred in the main process

When trying to enable the embedded Letta server on Letta Desktop Version 0.12.1-rev4 (2510223pslk38vu) on MacOS 26.1, got this error:


A JavaScript error occurred in the main process
Uncaught Exception:

Error: ENOENT, dist/alembic.ini not found in /Applications/Letta Desktop.app/Contents/Resources/app.asar

at createError (node:electron/js2c/node_init:2:2002)

at Object.func [as copyFileSync] (node:electron/js2c/node_init:2:2721)

at copyAlembicToLettaDir (/Applications/Letta Desktop.app/Contents/Resources/app.asar/dist/main.js:121:37)

at App.startLettaServer (/Applications/Letta Desktop.app/Contents/Resources/app.asar/dist/main.js:263:21)

at Timeout._onTimeout (/Applications/Letta Desktop.app/Contents/Resources/app.asar/dist/main.js:227:21)

at listOnTimeout (node:internal/timers:581:17)

at process.processTimers (node:internal/timers:519:7)

The embedded server has been removed from Letta Desktop and probably won’t come back. Do you have existing agents on an embedded server you may need to migrate? If so, we’ll have to do a little bit of letta-fu.

No worries! Just getting started with playing with Letta and Neo4j. Figured that using the embedded server would be my easy button for first exploration. Will go another route.

Yeah, I’d just run the docker version, it’s much more robust and pretty simple:

docker run \
  -v ~/.letta/.persist/pgdata:/var/lib/postgresql/data \
  -p 8283:8283 \
  -e OPENAI_API_KEY="your_openai_api_key" \
  letta/letta:latest

You can tag @ezra on here if you need misc technical support. Ezra is our support agent and is much quicker/smarter than I.