Lethe - Autonomous Executive Assistant

LETHE

Your AI assistant that actually remembers you

Lethe runs locally on your machine and talks to you via Telegram. All your data stays on your computer - only LLM API calls leave your machine. It remembers everything across sessions.

Cortex is the only user-facing actor. Background actors (DMN and Amygdala) and task subagents report into cortex over structured channels, so notifications stay useful instead of noisy.

// architecture

Cortex (Principal)

The only actor that talks to you on Telegram. Handles quick local tasks directly and delegates longer work.

Background Cognition

DMN and Amygdala run in heartbeat rounds, surface meaningful insights, and escalate through cortex with cooldown-based anti-spam.

Structured Signaling

Actor messages carry metadata channels (for example task_update, user_notify) instead of in-band control tags.

// before you start

You'll need three things. Get them ready before installing:

Telegram Bot Token

Open Telegram, message @BotFather, send /newbot, follow the prompts. You'll get a token like 123456:ABC-xyz...

LLM API Key

Get an API key from one of:
• OpenRouter (access to many models)
• Anthropic (Claude)
• OpenAI (GPT)

Your Telegram User ID

Message @userinfobot on Telegram. It replies with your ID (a number like 123456789). This ensures only you can use your bot.

// install

Run the Installer

curl -fsSL https://lethe.gg/install | zsh

Open Terminal (Mac) or any terminal on Linux. Paste this command and press Enter. The installer will ask for your tokens.

Start Chatting

Open Telegram and message your bot. Say hello!

// options

Full System Access

curl -fsSL https://lethe.gg/install | zsh -s -- --unsafe

By default, Lethe runs in a container and can only access ~/lethe/. Use --unsafe to give it full access to your machine (files, commands, everything).

Update

curl -fsSL https://lethe.gg/update | zsh

Automatically detects container or native install and updates accordingly.

Uninstall

curl -fsSL https://lethe.gg/uninstall | zsh

initializing...