explaingit

leon-ai/leon

Analysis updated 2026-06-24

17,224TypeScriptAudience · vibe coderComplexity · 4/5LicenseSetup · hard

TLDR

Self-hosted open-source personal assistant similar to Siri or Alexa, but private and extensible via a community skills system. Can run fully offline.

Mindmap

mindmap
  root((leon))
    Inputs
      Voice
      Text chat
      Skill definitions
    Outputs
      Voice reply
      Text reply
      Skill action
    Use Cases
      Self-host a private voice assistant
      Build a custom skill
      Run offline assistant on a home server
    Tech Stack
      TypeScript
      Node.js
      NLU
      Docker
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Self-host a private voice assistant that runs offline on your own machine

USE CASE 2

Write a custom skill that teaches Leon to call your home automation API

USE CASE 3

Replace Alexa or Siri for a small set of trusted commands with no cloud calls

USE CASE 4

Prototype a voice-driven workflow tool inside your own network

What is it built with?

TypeScriptNode.jsDockerPython

How does it compare?

leon-ai/leonbvaughn/react-windowsindresorhus/type-fest
Stars17,22417,17617,132
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs Node.js 16+ and Python deps, voice features add extra setup beyond the CLI install.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Leon is an open-source personal assistant that you self-host on your own server. Think of it like a private version of Siri or Alexa, one you control completely, with no data sent to third-party services unless you choose to. You can talk to Leon or text him, and he responds by voice or text. Because it runs on your own machine, it can also run fully offline, which is the project's key privacy promise. The core idea is a "skills" system: each skill is a small bundle of code that teaches Leon how to handle a specific type of request. This means anyone can build a new skill and share it, so the assistant grows through community contributions rather than being locked to whatever the original author built in. The README describes this as "one core to rule them all", you add capabilities as skills rather than building separate tools for each idea. Under the hood, Leon figures out what you mean using a natural language understanding system (NLU), software that interprets sentences into recognized intentions. The project is working toward eventually supporting large language models (LLMs, the same technology behind tools like ChatGPT) for cases where the intent system can't match what you asked. The server and web app are written in TypeScript. Installation is done via a command-line tool called the Leon CLI, and a Docker option is also available. It requires Node.js version 16 or higher. The project is MIT-licensed and openly welcomes contributions.

Copy-paste prompts

Prompt 1
Install leon-ai/leon with the Leon CLI on Ubuntu and run my first voice command
Prompt 2
Write a Leon skill that turns on my smart lights through the Home Assistant REST API
Prompt 3
Run leon-ai/leon in Docker with voice input working from my Mac browser
Prompt 4
Compare leon-ai/leon to Mycroft and Rhasspy for a privacy-focused home assistant

Frequently asked questions

What is leon?

Self-hosted open-source personal assistant similar to Siri or Alexa, but private and extensible via a community skills system. Can run fully offline.

What language is leon written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Docker.

What license does leon use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is leon to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is leon for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub leon-ai on gitmyhub

Verify against the repo before relying on details.