leon
I started working on Leon in 2017 and released the first open-source version in 2019.
Automatically checked · GitHub checked 2026-11-18

Overview

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
developbranch 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
# 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 checkto check your setup. - Downloads select supported Chinese mirrors when the downloading machine is in China. See download sources and overrides.
- Use the
masterbranch 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.
A few previews from the work in progress, using sample conversations and setup screens. Click a screenshot for a closer look.
Built for personal AI
A good model matters. So does everything around it. Leon has its own continuous agent loop, tool execution in isolated workers, progressive context management, and multi-layer memory. Here are a few of the choices behind it.
- Load what helps with the current task. Context and tool guidance arrive progressively, down to the function Leon needs. Large tool outputs stay in artifacts, and older exchanges are compacted when needed to keep the working context focused.
- Give tools a proper home. Tools declare their functions, settings, dependencies, and binaries. Their setup and execution follow defined code paths, so Leon can reuse a prepared capability the next time it needs it.
- Keep predictable workflows available. Native skills follow explicit actions. Agent skills guide the agent loop through more flexible tasks. Both use the same tool system.
- Remember selectively. Leon keeps temporary context, persistent facts and preferences, daily summaries, and recent discussion memory, isolated per profile. It retrieves relevant records when needed and can check original conversations for exact details.
- Act, observe, and recover. The agent loop uses tool results to decide what to do next, checks outcomes, and can recover from failures. Independent tool calls can run concurrently in isolated workers.
Understand the current project
While the new documentation is being written, these generated context files are useful starting points. Check the relevant source for the details.
core/context/LEON.mddescribes Leon's identity, behavior, and capabilities.core/context/ARCHITECTURE.mdexplains how the runtime, memory, tools, skills, and clients fit together.
Personal AI, measured in practice
We are building Leon to push the state of the art in personal AI. In our published comparisons, Leon leads the overall scores on selected WildClawBench and PinchBench tasks.
Explore the results across different dimensions, along with the methods and limitations, at benchmarks.getleon.ai.
Philosophy
I love building personal AI. I've spent years on it, and I still have so many things I want to try. At the same time, I want us to enjoy the process. To understand what we build. To have a life outside our screens too.
There is already enough noise around AI. You should be able to open Leon, feel at home, and take things at your own pace. I want 2.0 to feel warm, cozy, and made with care.
-
Human craft still matters. We use AI to help us build, learn, and improve the quality of our work. We also take the time to understand it, make decisions, and check the result. I want us to feel proud of what we put into Leon. Even with AI and coding agents helping us, I want us to keep having those little "yes, I did it!" moments.
-
Personal AI should belong to you. An assistant that knows you well will hold things that matter to you. That's a responsibility. Leon is open source, can run on your own machine, and supports local and remote models. You choose the models and services you connect it to.
-
Open source is about people too. Sharing code is part of it. So is helping someone get started, listening to feedback, explaining a decision, and learning from each other. That's the kind of project I want Leon to be.
-
We have time to do things with care. I want Leon to help you make room for your own ideas, your creativity, and the people around you. The same goes for how we build it. A thoughtful improvement, a good conversation, a useful fix. These things count.
I wrote more about this in Before Leon AI 2.0, I want to say this.
Let's build the next chapter together
If you have been following Leon for years, thank you for sticking around. If you just found the project, welcome. I'm glad you're here.
For a long time, I kept contributions limited because I was rewriting Leon and making frequent breaking changes. That's why the contributor count is still small. I wanted to get the foundations into a better place before asking people to invest their time.
More than 100 people have already expressed interest in actively contributing to Leon AI. That means a lot to me.
After the first 2.0 alpha release, we'll bring this community together and work on improving Leon. We'll share ideas, have community calls, build useful things, and help each other along the way. I want people to feel comfortable asking questions and sharing work they care about.
A place where you know the people behind the usernames. Where we respect each other's time and opinions. Where it's nice to hang out, even when we're just figuring things out.
You can already join our Discord to meet us and follow what's happening.
And if you would like to take part in building Leon, fill out the Leon AI contributor interest form. It helps me get to know you and organize the next steps while we prepare the alpha.
You can help with code, testing, documentation, design, translation, videos, or welcoming others. You don't need to be a developer to have something valuable to bring.
For now, the core and interface are still moving quite a bit. I'm organizing contributions with that in mind, so we can give people a useful place to start and respect the time they offer.
Really looking forward to seeing what we make together.
给中国朋友们的一点问候
大家好 👋 我是 Louis,一个住在深圳的法国人。很开心能通过 Leon 认识你们。欢迎来聊聊、分享想法,或者一起做点有意思的东西。希望这里也能让你们感到自在,就像和朋友在一起一样。
Follow along
I share progress most regularly on X / @grenlouis. You can also follow along through the links below.
For the longer backstory, read the story behind Leon.
Author
Louis Grenard (@grenlouis)
Support Leon
If you'd like to support the time and care that go into this project, you can sponsor Leon.
Leon is shared under the MIT license.












