Leon Save

🧠 Leon is your open-source personal assistant.

Project README


Your open-source personal assistant.

Website :: Documentation :: Roadmap :: Contributing :: Story

📢 Notice 📢

Many exciting things are coming up, hence no new documentation and test are going to be written until the official release of Leon. Feel free to join us on Discord to know more and to read the "A Much Better NLP and Future" blog post.

👋 Introduction

Leon is an open-source personal assistant who can live on your server.

He does stuff when you ask him to.

You can talk to him and he can talk to you. You can also text him and he can also text you. If you want to, Leon can communicate with you by being offline to protect your privacy.


  1. If you are a developer (or not), you may want to build many things that could help in your daily life. Instead of building a dedicated project for each of those ideas, Leon can help you with his Skills structure.
  2. With this generic structure, everyone can create their own skills and share them with others. Therefore there is only one core (to rule them all).
  3. Leon uses AI concepts, which is cool.
  4. Privacy matters, you can configure Leon to talk with him offline. You can already text with him without any third party services.
  5. Open source is great.

What is this repository for?

This repository contains the following nodes of Leon:

  • The server
  • Skills
  • The web app
  • The hotword node
  • The TCP server (for inter-process communication between Leon and third-party processes such as spaCy)
  • The Python bridge (the connector between Python core and skills)

What is Leon able to do?

Today, the most interesting part is about his core and the way he can scale up. He is pretty young but can easily scale to have new features (skills). You can find what he is able to do by browsing the skills list.
Please do know that after the official release, we will build many skills along with the community. Feel free to join us on Discord to be part of the journey.

Sounds good to you? Then let's get started!

☁️ Try with a Single-Click

Gitpod will automatically setup an environment and run an instance for you.

Open in Gitpod

🚀 Getting Started


  • Node.js >= 16
  • npm >= 8
  • Supported OSes: Linux, macOS and Windows

To install these prerequisites, you can follow the How To section of the documentation.


# Install the Leon CLI
npm install --global @leon-ai/cli

# Install Leon (stable branch)
leon create birth
# OR install from the develop branch: leon create birth --develop


# Check the setup went well
leon check

# Run
leon start

# Go to http://localhost:1337
# Hooray! Leon is running

Docker Installation

# Install Leon
leon create birth --docker

# Run
leon start

# Go to http://localhost:1337
# Hooray! Leon is running

📚 Documentation

For full documentation, visit docs.getleon.ai.

📺 Video

Watch a demo.

🧭 Roadmap

To know what is going on, follow roadmap.getleon.ai.

❤️ Contributing

If you have an idea for improving Leon, do not hesitate.

Leon needs open source to live, the more skills he has, the more skillful he becomes.

📖 The Story Behind Leon

You'll find a write-up on this blog post.

🔔 Stay Tuned

👨 Author

Louis Grenard (@grenlouis)

👍 Sponsors

250 USD / month
100 USD / month
Keith Myers
10 USD / month
Andrin Meier
10 USD / month

You can also contribute by sponsoring Leon.

Please note that I dedicate most of my free time to Leon.

By sponsoring the project you make the project sustainable and faster to develop features.

The focus is not only limited to the activity you see on GitHub but also a lot of thinking about the direction of the project. Which is naturally related to the overall design, architecture, vision, learning process and so on...

Special Thanks

Vercel       MacStadium       AOZ Studio

📝 License

MIT License

Copyright (c) 2019-present, Louis Grenard [email protected]



Open Source Agenda is not affiliated with "Leon" Project. README Source: leon-ai/leon

Open Source Agenda Badge

Open Source Agenda Rating