2019-02-10 15:26:50 +03:00
< p align = "center" >
2021-12-05 18:24:42 +03:00
< a href = "https://getleon.ai" > < img width = "800" src = "https://getleon.ai/img/hero-animation.gif" / > < / a >
2019-02-10 15:26:50 +03:00
< / p >
2021-12-05 16:13:44 +03:00
< h1 align = "center" >
< a href = "https://getleon.ai" > < img width = "96" src = "https://getleon.ai/img/logo.svg" alt = "Leon" > < / a > < br >
Leon
< / h1 >
2019-02-10 15:26:50 +03:00
*< p align = "center" > Your open-source personal assistant.< / p > *
< p align = "center" >
2021-03-21 10:08:20 +03:00
< a href = "https://github.com/leon-ai/leon/blob/develop/LICENSE.md" > < img src = "https://img.shields.io/badge/license-MIT-blue.svg?label=License&style=flat" / > < / a >
2021-03-21 09:58:14 +03:00
< a href = "https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md" > < img src = "https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat" / > < / a >
< br >
2021-04-22 11:52:40 +03:00
< a href = "https://github.com/leon-ai/leon/actions/workflows/build.yml" > < img src = "https://github.com/leon-ai/leon/actions/workflows/build.yml/badge.svg?branch=develop" / > < / a >
< a href = "https://github.com/leon-ai/leon/actions/workflows/tests.yml" > < img src = "https://github.com/leon-ai/leon/actions/workflows/tests.yml/badge.svg?branch=develop" / > < / a >
< a href = "https://github.com/leon-ai/leon/actions/workflows/lint.yml" > < img src = "https://github.com/leon-ai/leon/actions/workflows/lint.yml/badge.svg?branch=develop" / > < / a >
2021-03-13 11:59:52 +03:00
< br >
2021-03-13 12:08:55 +03:00
< a href = "https://discord.gg/MNQqqKg" > < img src = "https://svgshare.com/i/V09.svg" / > < / a >
2021-03-21 09:58:14 +03:00
< a href = "https://twitter.com/louistiti_fr" > < img src = "https://img.shields.io/twitter/follow/louistiti_fr?label=Follow&style=social" / > < / a >
2019-02-10 15:26:50 +03:00
< / p >
< p align = "center" >
2021-03-13 12:08:55 +03:00
< a href = "https://getleon.ai" > Website< / a > ::
< a href = "https://docs.getleon.ai" > Documentation< / a > ::
2021-12-12 07:31:22 +03:00
< a href = "http://roadmap.getleon.ai" > Roadmap< / a > ::
2019-02-17 17:25:33 +03:00
< a href = "https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md" > Contributing< / a > ::
2021-03-13 12:08:55 +03:00
< a href = "https://blog.getleon.ai/the-story-behind-leon/" > Story< / a >
2019-02-10 15:26:50 +03:00
< / p >
---
2021-03-16 16:16:17 +03:00
## 👋 Introduction
2019-02-10 15:26:50 +03:00
2021-04-06 11:18:47 +03:00
**Leon** is an **open-source personal assistant** who can live **on your server** .
2019-02-10 15:26:50 +03:00
2019-02-23 13:39:06 +03:00
He **does stuff** when you **ask him for** .
2019-02-10 15:26:50 +03:00
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** .
### Why?
2019-03-30 07:23:59 +03:00
2019-02-10 15:26:50 +03:00
> 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
> packages/modules (skills) structure.
2019-02-20 15:38:52 +03:00
> 2. With this generic structure, everyone can create their own modules and share them with others.
2019-02-18 14:18:17 +03:00
> Therefore there is only one core (to rule them all).
2019-02-10 15:26:50 +03:00
> 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.
2019-03-30 07:18:37 +03:00
> 5. Open source is great.
2019-02-10 15:26:50 +03:00
### What is this repository for?
2019-03-30 07:23:59 +03:00
2019-02-10 15:26:50 +03:00
> This repository contains the following nodes of Leon:
> - The server
> - The packages/modules
> - The web app
> - The hotword node
2019-03-30 07:23:59 +03:00
### 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 (packages/modules).
> You can find what he is able to do by browsing the [packages list](https://github.com/leon-ai/leon/tree/develop/packages).
2019-02-10 15:26:50 +03:00
Sounds good for you? Then let's get started!
2021-04-23 05:20:16 +03:00
## ☁️ Try with a Single-Click
Gitpod will automatically setup an environment and run an instance for you.
[![Open in Gitpod ](https://gitpod.io/button/open-in-gitpod.svg )](https://gitpod.io/#https://github.com/leon-ai/leon)
2021-03-16 16:16:17 +03:00
## 🚀 Getting Started
2019-02-10 15:26:50 +03:00
### Prerequisites
2021-11-07 05:24:00 +03:00
- [Node.js ](https://nodejs.org/ ) >= 16
- [npm ](https://npmjs.com/ ) >= 8
2019-02-10 15:26:50 +03:00
- Supported OSes: Linux, macOS and Windows
To install these prerequisites, you can follow the [How To section ](https://docs.getleon.ai/how-to/ ) of the documentation.
### Installation
```sh
2021-12-12 10:50:25 +03:00
# Install the Leon CLI
2022-01-25 16:48:20 +03:00
npm install --global @leon -ai/cli
2019-02-10 15:26:50 +03:00
2021-12-12 10:50:25 +03:00
# Install Leon (stable branch)
leon create birth
# OR install from the develop branch: leon create birth --develop
2019-02-10 15:26:50 +03:00
```
### Usage
```sh
# Check the setup went well
2021-12-12 10:50:25 +03:00
leon check
2019-02-10 15:26:50 +03:00
# Run
2021-12-12 10:50:25 +03:00
leon start
2019-02-10 15:26:50 +03:00
# Go to http://localhost:1337
# Hooray! Leon is running
```
2019-02-23 16:27:28 +03:00
### Docker Installation
```sh
2021-12-12 10:50:25 +03:00
# Install Leon
leon create birth --docker
2019-02-23 16:27:28 +03:00
2021-04-05 18:47:34 +03:00
# Run
2021-12-12 10:50:25 +03:00
leon start
2019-02-23 16:27:28 +03:00
# Go to http://localhost:1337
# Hooray! Leon is running
```
2021-03-16 16:16:17 +03:00
## 📚 Documentation
2019-02-10 15:26:50 +03:00
For full documentation, visit [docs.getleon.ai ](https://docs.getleon.ai ).
2021-12-05 16:13:44 +03:00
## 📺 Video
[Watch a demo ](https://www.youtube.com/watch?v=p7GRGiicO1c ).
2021-03-16 16:20:49 +03:00
## 🧭 Roadmap
2019-02-10 15:26:50 +03:00
2021-12-12 07:31:22 +03:00
To know what is going on, follow [roadmap.getleon.ai ](http://roadmap.getleon.ai ).
2019-02-10 15:26:50 +03:00
2021-03-16 16:16:17 +03:00
## ❤️ Contributing
2019-02-10 15:26:50 +03:00
2019-02-23 13:39:06 +03:00
If you have an idea for improving Leon, do not hesitate.
2019-02-10 15:26:50 +03:00
2019-03-30 07:18:37 +03:00
**Leon needs open source to live**, the more modules he has, the more skillful he becomes.
2019-02-10 15:26:50 +03:00
2021-03-16 16:16:17 +03:00
## 📖 The Story Behind Leon
2019-02-17 17:25:33 +03:00
You'll find a write-up on this [blog post ](https://blog.getleon.ai/the-story-behind-leon/ ).
2021-03-16 16:16:17 +03:00
## 🔔 Stay Tuned
2021-12-05 16:13:44 +03:00
- [Twitter ](https://twitter.com/louistiti_fr )
2021-12-24 04:20:44 +03:00
- [Newsletter ](http://newsletter.getleon.ai )
2019-02-10 15:26:50 +03:00
- [Blog ](https://blog.getleon.ai )
- [GitHub issues ](https://github.com/leon-ai/leon/issues )
2021-12-05 16:13:44 +03:00
- [YouTube ](https://www.youtube.com/channel/UCW6mk6j6nQUzFYY97r47emQ )
2019-02-10 15:26:50 +03:00
- [#LeonAI ](https://twitter.com/hashtag/LeonAI )
2021-03-16 16:16:17 +03:00
## 👨 Author
2019-02-10 15:26:50 +03:00
**Louis Grenard** ([@louistiti_fr](https://twitter.com/louistiti_fr))
2021-08-07 12:54:16 +03:00
## 👍 Sponsors
< table >
< tbody >
< tr >
2021-11-09 15:48:59 +03:00
< td align = "center" valign = "middle" width = "128" >
< a href = "https://github.com/Francaoz" >
< img src = "https://github.com/Francaoz.png?size=128" / >
Francaoz
< / a > < br >
< sub > < sup > 100 USD / month< / sup > < / sub >
< / td >
2021-08-07 12:54:16 +03:00
< td align = "center" valign = "middle" width = "128" >
2021-12-07 17:44:22 +03:00
< a href = "https://github.com/GregoireAMATO" >
< img src = "https://github.com/GregoireAMATO.png?size=128" / >
2021-08-07 12:54:16 +03:00
GrAMATO
< / a > < br >
2022-01-31 05:01:09 +03:00
< sub > < sup > 17 USD / month< / sup > < / sub >
2021-08-07 12:54:16 +03:00
< / td >
2021-12-21 17:28:15 +03:00
< td align = "center" valign = "middle" width = "128" >
< a href = "https://github.com/phareal" >
< img src = "https://github.com/phareal.png?size=128" / >
phareal
< / a > < br >
< sub > < sup > 17 USD / month< / sup > < / sub >
< / td >
2021-08-17 18:43:01 +03:00
< td align = "center" valign = "middle" width = "128" >
2022-01-31 05:01:09 +03:00
< a href = "https://github.com/Divlo" >
< img src = "https://github.com/Divlo.png?size=128" / >
Divlo
2021-08-17 18:43:01 +03:00
< / a > < br >
< sub > < sup > 10 USD / month< / sup > < / sub >
< / td >
2021-08-07 12:54:16 +03:00
< td align = "center" valign = "middle" width = "128" >
2021-12-12 07:31:22 +03:00
< a href = "http://sponsor.getleon.ai/" >
2021-08-07 12:54:16 +03:00
You?
< / a >
< / td >
< / tr >
< / tbody >
< / table >
2019-02-10 15:26:50 +03:00
2021-12-12 07:31:22 +03:00
You can also contribute by [sponsoring Leon ](http://sponsor.getleon.ai ).
2019-02-10 15:26:50 +03:00
2021-06-05 18:08:10 +03:00
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...
2021-12-07 17:44:22 +03:00
### Special Thanks
< a href = "https://vercel.com/?utm_source=leon-ai&utm_campaign=oss" >
< img src = "https://i.imgur.com/S5olXWh.png" alt = "Vercel" width = "128" / >
< / a >
2021-03-16 16:16:17 +03:00
## 📝 License
2019-02-10 15:26:50 +03:00
[MIT License ](https://github.com/leon-ai/leon/blob/develop/LICENSE.md )
Copyright (c) 2019-present, Louis Grenard < louis.grenard @ gmail . com >
## Cheers!
2021-03-16 16:16:17 +03:00
![Cheers! ](https://github.githubassets.com/images/icons/emoji/unicode/1f379.png "Cheers!" )