0 Fork 0

mirror of https://github.com/alexbelgium/hassio-addons.git synced 2026-11-04 03:42:14 +00:00

Files

T

831c5eec82 feat(letta_code): new add-on for the Letta Code AI agent platform (#3139 )

* add letta_code addon

* address pr review comments

* tweak env_vars regex and readme port note

* drop nginx, wrap upstream entrypoint, simplify build

* secure system cron paths and doc bearer auth

* persist cron paths in config with non-root sanitization

* letta_code: drop PUID/PGID and the cron sanitizer, run as root like upstream

The non-root branch rewrote cron field 6 root->node, which misses
@reboot/@daily lines (user is field 2) and mapped to node, not PUID.
Upstream's entrypoint installs cron and starts it as root before gosu
anyway. Run as root like the upstream image: drop gosu, the PUID/PGID
options, the recursive chown and the extra cron dirs (the entrypoint
creates them under ~/.letta, linked to /config/.letta).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* letta_code: drop trailing blank line

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: BirdNET-Go Addon Builder <addon-builder@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-23 23:03:21 +03:00

3.3 KiB

Raw Permalink Blame History

Home Assistant Add-on: Letta Code

Stateful AI agent platform and App Server with long-term memory, skills, and multi-agent reasoning.

Letta Code is an open-source development agent and App Server by Letta AI. It features stateful agents that remember across sessions using MemFS, execute tools in local or cloud sandboxes, and expose an OpenAI-compatible API and WebSocket server.

Features

Stateful AI development agents with persistent memory (MemFS)
Built-in App Server for WebSocket and HTTP agent orchestration
OpenAI-compatible API (/v1/models, /v1/chat/completions, /v1/responses)
Local and cloud execution backends
Persistent workspace and agent storage in /config

Installation

Add this repository to Home Assistant.
Install the Letta Code add-on.
Configure your API keys in the add-on's Configuration tab (see below).
Start the add-on.
Enable port 4500 under the Network section in the add-on's Configuration tab, then connect clients to http://homeassistant:4500 (or ws://homeassistant:4500/ws).

Configuration

Option	Default	Description
`backend`	`local`	Agent execution backend: `local` or `cloud`.
`openai_api`	`true`	Enable OpenAI-compatible endpoints (`/v1/models`, `/v1/chat/completions`, etc.).
`token`	(generated)	App Server capability token. If not specified, a secure random token is generated in `/config/app-server-token`.
`TZ`	none	Container timezone (e.g. `America/New_York` or `UTC`).
`env_vars`	`[]`	Extra environment variables such as `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or `LETTA_API_KEY`.

Setting API Keys

Provide your LLM API keys via the env_vars option:

env_vars:
  - name: OPENAI_API_KEY
    value: sk-...
  - name: ANTHROPIC_API_KEY
    value: sk-ant-...

Endpoints & API Access

Letta Code serves its App Server on port 4500:

Authentication: Read the token from /config/app-server-token (or use the configured token option) and send it as Authorization: Bearer <token> with HTTP requests and WebSocket connections.
Direct Access (Port 4500): Port 4500 is disabled by default for security so capability tokens are not sent over unencrypted connections. To enable direct WebSocket and OpenAI API access, specify port 4500 under the Network section in the add-on's Configuration tab (or route through a reverse proxy terminating TLS/HTTPS):
- Health Check: http://homeassistant:4500/healthz
- Readiness: http://homeassistant:4500/readyz
- Server Info: http://homeassistant:4500/app-server-info
- WebSocket Protocol: ws://homeassistant:4500/ws
- OpenAI API Compatible: http://homeassistant:4500/v1/chat/completions

Storage & Persistence

Letta Code stores state, databases, credentials, and MemFS memory in /config/.letta, which is symlinked to /root/.letta. Project workspace files reside in /config/workspace (symlinked to /workspace). All state persists across add-on restarts and container rebuilds.

3.3 KiB Raw Permalink Blame History