Skip to main content
Version: 1.0.0-beta.5+dev

Introduction

What is Leon?#

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.

You can think of him as a second brain.

Tip

Leon is still pretty young today. If you wish, you can help by contributing ❤️

Demo#

A video is available here.

Motivations#

  1. As developers (or not), we love creating things, even more when those things can help in our daily life. So instead of building a dedicated project for each of those things, Leon can help us with his packages/modules (skills) structure. We believe it's better than keeping your awesome ideas in backlog forever, right?
  2. With this generic structure, everyone can create their own modules and share them. 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 interact with him without any third party services.
  5. Last but not least: open source is great.

Try with a Single-Click#

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

Open in Gitpod

Installation#

Prerequisites#

  • Node.js >= 16

    Leon's core is developed on the top of the Node.js JavaScript runtime.

  • npm >= 8

    npm is the packages manager of Node.js, Leon needs it for his core's dependencies tree.

  • Python >= 3

    Today, Leon's modules are only written in Python.

  • Pipenv >= 2020.11.15

    Pipenv allows Leon's modules to be executed in a dedicated environment. It also embeds a Python packages manager for the dependencies tree of his modules.

  • Supported OSes: Linux, macOS and Windows

    Should we explain that one? :)

Tip

You can read the How To section to install these prerequisites.

Download#

The master branch is actually used as a snapshot of the latest release:

git clone -b master https://github.com/leon-ai/leon.git leon

Install#

Now you can install:

# Go to the project root
cd leon
# Install
npm install

Usage#

Please ensure the whole setup went well with the following command:

npm run check

This command gives you a report about how much Leon is installed/configured. Do not worry if you have some warnings in the report, this is because you probably did not configure Leon yet.

If the report mentions that Leon can run correctly, then you can build and start Leon:

# Build
npm run build
# Run
npm start
# Go to http://localhost:1337
# Hooray! Leon is running

Basically on that level you can already communicate with him by text and ask him to do things.

Tip

To see what he can do, please refer to the packages list.