leon-ai /leon

🧠 Leon is your open-source personal assistant.

★ 17,682⑂ 1,483👁 266⑃ 248● 333▤ 23
TypeScriptMITCreated 2019-02-10getleon.ai
Download: TCP Server 2.0.0tcp-server_v2.0.0 ↓2.0.02026-02-19
+6
Daily
17,682
stars
1,483
forks
266
watchers
248
prs
333
issues
23
releases

README

Leon


Your open-source personal AI assistant.


  🇬🇧 English ·
  🇨🇳 简体中文 ·
  🇫🇷 Français



  
  



  Follow progress on X / @grenlouis ·
  Website ·
  Newsletter ·
  Roadmap ·
  Story


---

 [!IMPORTANT]
 We are working toward the first Leon 2.0 alpha, with a desktop application.
 It is not released yet. The develop branch is where this work happens, and
 things are still changing. The new documentation is not ready either; the
 public docs and older guides mostly describe the previous version.

 You can already try the unfinished new web app locally at
 http://localhost:5366/web-app/ after setting
 up Leon. More on that below.

 A few words before 2.0

Hi, I'm Louis 👋

I started working on Leon in 2017 and released the first open-source version in 2019. I've been building it ever since.

The idea is still the same. A personal AI assistant that gets to know you, remembers what matters to you, and helps you do things in your everyday life.

Humans at the center. I want Leon to feel warm, cozy, and made with care. A place where you can create and take things at your own pace. There is more about our philosophy below, but first, here's how to try it.

 Try the preview

If you are curious and comfortable running a project from source, you can explore the current work now.

The desktop application is planned for the first 2.0 alpha. Until then, you can get an early look through the new web app. It is not ready yet, but it will give you a feel for where Leon is going.

 Set up Leon

- macOS, Linux, or Windows
- Node.js = 24

sh
 Clone the repository
git clone https://github.com/leon-ai/leon.git

 Go to the project root
cd leon

 Install pnpm
npm install --global pnpm@latest

 Install dependencies
pnpm install

 Run Leon
pnpm start


- Follow the setup prompts during pnpm install.
- Open http://localhost:5366/web-app/ for the new web app. The legacy interface is still at /.
- Run pnpm run check to check your setup.
- Use the master branch for the previous, pre-agentic version.

 A little look inside

There is already plenty you can do with Leon. Try it with something you actually need help with and get a feel for it yourself.

Aurora is Leon's component library, crafted to bring interactive charts, forms, and visual answers into your conversations.

Vibes brings a little of the world outside into the app, with ambient scenes that follow the season, time of day, and weather.

I asked Leon to “Show how to search sessions by recording a new tutorial”. Here’s the video it made.

https://github.com/user-attachments/assets/90d0880a-7e87-4063-a5bb-09d400da6bc0

A few previews from the work in progress, using sample conversations and setup screens. Click a screenshot for a closer look.

| The new web app and Vibes | Task planning and execution |
| --- | --- |
|  |  |

| Generative UI with trend charts | Generative UI with a bar chart |
| --- | --- |
|  |  |

| Connecting your tools | A little help with coding |
| --- | --- |
|  |  |

 Built for personal AI

Top issues

Latest release

TCP Server 2.0.0 tcp-server_v2.0.0 Pre-release 2026-02-19
Leon's TCP server to communicate between the core and third-party nodes.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON