Lemon

Appearance

Open source · MIT · pre-1.0

Your agents.Your machine.Your move.

Meet Lemon — a local-first AI assistant that brings your models, tools, and conversations together, and keeps useful context close.

curl -fsSL https://raw.githubusercontent.com/z80dev/lemon/main/install.sh | sh
Get started Star on GitHub

Self-hosted · macOS & Linux · Built on Elixir / OTP

Durable sessions Native subagents Memory & recall Reusable skills Your models, your keys Terminal Browser Telegram & Discord MCP tools Supervised on the BEAM LemonSim arenas

From a prompt to a practice

Good work deserves
a place to continue.

One runtime for everything an assistant needs beyond its next answer.

Context that sticks around.

Come back to durable sessions, search useful memory, and turn repeatable workflows into skills. Your project conventions stay close to the work.

Explore memory

More than one pair of hands.

Delegate to native subagents in the same runtime, or send work to a named execution node — all coordinated from one conversation.

Meet the runtime

Bring any brain.

Configure providers and models through one platform. Files and runtime state stay on your machine; the model is your call.

Set up a provider

Built to be poked at.

Inspect runs, validate configuration, diagnose setup, and back up durable state. Real tools for the work after “hello world.”

See the support tools

Solid foundations

Agents are a
concurrency problem.

Tools run. Messages arrive. Sessions wait. Work gets delegated. Lemon uses the BEAM’s lightweight processes and supervision to give all that activity a structure you can reason about — and when something crashes, it gets restarted while everything else keeps working.

Why we built on the BEAM

Wherever you work

One lemon.
Three doors.

The same sessions, memory, and tools — from a terminal, a browser tab, or the chat app already on your phone.

Terminal

A fast TUI for long coding sessions, with slash commands and resumable history.

Browser

Pick up any session in the web interface, with files, runs, and history alongside.

Chat

Talk to the same assistant from Telegram, Discord, and other channels.

Pick your starting point

Make something happen.

Use Lemon

Your first real conversation.

Install, connect a provider, start a chat, and come back to the same session tomorrow.

Follow the quickstart Build with Lemon

Make it your own.

Explore the agent stack, write reusable skills, and build on the control plane.

Build your first agent Explore LemonSim

Put agents to the test.

Run deterministic, event-sourced simulation worlds with replay verification.

Enter the arena

Early days.
Real building blocks.

Lemon is pre-1.0 and evolving fast. Start with the supported install path, explore the documented capabilities, and help shape what comes next.

Install Lemon Capabilities & boundaries

What is Lemon? ​

Lemon is an open-source, local-first AI assistant platform for developers and technical operators. A supervised Elixir / OTP runtime connects durable sessions, memory, skills, tools, provider routing, and native multi-agent execution. Use it from the terminal, the browser, or a chat channel such as Telegram or Discord. LemonSim adds deterministic, replay-verified simulation worlds for evaluating agents. Lemon is pre-1.0; see capabilities and boundaries for what is supported today.

Install ​

Prebuilt releases target macOS Apple Silicon, Linux x86_64, and Linux ARM64. The installer needs curl, tar, and python3, installs under ~/.lemon, and opens the setup wizard to configure a provider:

bash
curl -fsSL https://raw.githubusercontent.com/z80dev/lemon/main/install.sh | sh
$HOME/.lemon/bin/lemon

Source checkouts, non-interactive installs, channels, and updates are covered in Install; the Quickstart walks through a first provider-backed chat.

Find your way around ​

The documentation index lists every page by task. Coming from Hermes? See Migrate from Hermes.

Released under the MIT License.

Copyright 2024-2026 z80