+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
#37Add a tutorial to install on a Raspberry Pi23 comments · 2019-02-22#480TCP CLIENT :. 🚨 Failed to connect to the TCP server.: 21 comments · 2023-04-27#25improve the Isitdown module20 comments · 2019-02-18#28Hardware / Scaling requirements15 comments · 2019-02-19#30Time module14 comments · 2019-02-19#64Spotify Package11 comments · 2019-03-24#43Forecast/weather package11 comments · 2019-02-26#234Support for modern TTS models for various languages10 comments · 2021-04-02
Latest release
TCP Server 2.0.0 tcp-server_v2.0.0 Pre-release 2026-02-19Leon's TCP server to communicate between the core and third-party nodes.