mirror of https://github.com/leon-ai/leon.git synced 2024-12-01 03:15:58 +03:00

🧠 Leon is your open-source personal assistant.

Go to file

Louistiti d558fc8b7c docs: add `What is Leon able to do?` section in the readme		2019-03-30 12:23:59 +08:00
.circleci	chore: init	2019-02-10 20:26:50 +08:00
.github	docs: open-source != open source	2019-03-30 12:18:37 +08:00
app	feat: allow HTML output	2019-03-24 08:17:40 +08:00
bin	chore: init	2019-02-10 20:26:50 +08:00
bridges	refactor(server): transform `code` property output to a `codes` list	2019-03-28 08:45:37 +08:00
core	refactor(server): use full query object path as child process arg	2019-03-02 16:41:35 +08:00
downloads	chore: init	2019-02-10 20:26:50 +08:00
hotword	chore: init	2019-02-10 20:26:50 +08:00
logs	chore: init	2019-02-10 20:26:50 +08:00
packages	refactor(server): transform `code` property output to a `codes` list	2019-03-28 08:45:37 +08:00
scripts	refactor(server): use full query object path as child process arg	2019-03-02 16:41:35 +08:00
server/src	feat: allow HTML output	2019-03-24 08:17:40 +08:00
test	test(server): add broken classifier test for NLU	2019-03-16 08:41:26 +08:00
.babelrc	chore: init	2019-02-10 20:26:50 +08:00
.changelogrc	chore: init	2019-02-10 20:26:50 +08:00
.dockerignore	fix: Leon was not fully installed with Docker if a `.env` file was existing	2019-03-10 09:47:37 +08:00
.editorconfig	chore: init	2019-02-10 20:26:50 +08:00
.env.sample	style: improve LC_ALL and LANG comment	2019-02-24 16:49:14 +08:00
.eslintrc.json	chore: init	2019-02-10 20:26:50 +08:00
.gitignore	refactor(server): give query object file in child process arg	2019-03-02 12:54:25 +08:00
CHANGELOG.md	build: release 1.0.0-beta.1	2019-02-24 18:12:28 +08:00
Dockerfile	Remove `apk update` in Dockerfile	2019-03-09 17:46:39 +08:00
ide.js	chore: init	2019-02-10 20:26:50 +08:00
LICENSE.md	chore: init	2019-02-10 20:26:50 +08:00
package-lock.json	test(server): fix brain executions	2019-03-16 07:50:30 +08:00
package.json	test: fixed sequential execution due to the new NLU implementation	2019-03-05 08:38:18 +08:00
README.md	docs: add `What is Leon able to do?` section in the readme	2019-03-30 12:23:59 +08:00

README.md

Leon

Your open-source personal assistant.

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

Introduction

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

He does stuff when you ask him for.

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?

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.

With this generic structure, everyone can create their own modules and share them with others. Therefore there is only one core (to rule them all).

Leon uses AI concepts, which is cool.

Privacy matters, you can configure Leon to talk with him offline. You can already text with him without any third party services.

Open source is great.

What is this repository for?

This repository contains the following nodes of Leon:

The server

The packages/modules

The web app

The hotword node

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.

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

Getting Started

Prerequisites

Node.js >= 10
npm >= 5
Python 3.6.x
Pipenv
Supported OSes: Linux, macOS and Windows

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

Installation

# Clone the repository (stable branch)
git clone -b master https://github.com/leon-ai/leon.git leon
# OR download the latest release at: https://github.com/leon-ai/leon/releases/latest

# Go to the project root
cd leon

# Install
npm install

Usage

# Check the setup went well
npm run check

# Build
npm run build

# Run
npm start

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

Docker Installation

# Build
npm run docker:build

# Run 
npm run docker:run

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

Documentation

For full documentation, visit docs.getleon.ai.

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 modules he has, the more skillful he becomes.