leon README

The project's README from github.com/leon-ai/leon. As one markdown file: README.md.

Leon
Leon

Your open-source personal AI assistant.

I share Leon progress most regularly on X / @grenlouis

Follow progress on X / @grenlouis · Website · Newsletter · Roadmap · Story


⚠️ Important Notice (as of 2026-03-29)

[!IMPORTANT] Leon is currently focused on the 2.0 Developer Preview on the develop branch.

  • The new documentation is not ready yet.
  • The current docs site and older guides mostly reflect the legacy architecture.
  • If you want the legacy, more stable pre-agentic version of Leon, use the master branch.
  • If you want to explore or contribute to Leon's new core, develop is the right place.

The most accurate high-level references for Leon's current state are:

👋 Introduction

Leon is your open-source personal AI assistant built around tools, context, memory, and agentic execution.

Leon is designed to stay practical, privacy-aware, and grounded in your real environment. It can operate locally, use dedicated tools instead of relying on free-form guessing, and complete tasks from start to finish across deterministic workflows and agent-style execution.

🧠 What Leon Is Today

Leon is no longer just a classic intent-classification assistant like it was for its first release in 2019.

Today, Leon is being built as a more capable assistant that can understand a goal, choose how to handle it, use tools, remember useful information, and recover when something goes wrong.

Leon also keeps a compact self-model and a bounded proactive pulse system so it can stay more consistent over time without flooding itself with unnecessary context.

Why?

🚀 Getting Started

Prerequisites

Recommended: manage Node.js with Volta.

Installation

# Clone the repository
git clone https://github.com/leon-ai/leon.git

# Go to the project root
cd leon

# Install pnpm
npm install --global pnpm@latest

# Install dependencies
pnpm install

Run Leon

# Run Leon
pnpm start

Check Your Setup

# Check the setup went well
pnpm run check

By default, Leon runs locally and the app is available on http://localhost:5366.

🏗️ Architecture Snapshot

At a high level, Leon currently consists of:

This repository already includes skills and toolkits for areas such as search, productivity, system utilities, media workflows, coding assistance, memory-backed interactions, and voice/audio features.

📚 Documentation Status

The new docs for Leon 2.0 are not ready yet.

For now:

❤️ Contributing

We are starting to progressively onboard contributors for the 2.0 Developer Preview.

If you want to follow the project or express interest in joining that onboarding:

Why is there a small amount of contributors?

Leon has been evolving for a long time, but the current 2.0 work is a major transition period.

For a long time, Leon was a smaller assistant project with a simpler architecture. Today, the core is being rebuilt into a much more capable system around tools, memory, context, and agent-style execution. That means a lot of things are still moving, and it makes contribution harder than it will be once the new docs and architecture settle down.

Another important reason is simply time: Leon is still developed largely during spare time. So progress can be uneven, and opening the project more broadly has to be balanced with keeping the direction coherent while the 2.0 Developer Preview is still taking shape.

📖 The Story Behind Leon

Leon started in 2017 and has been active since 2019. If you want the longer backstory, read the story behind Leon.

🔔 Stay Tuned

👨 Author

Louis Grenard (@grenlouis)

👍 Sponsors

You can also contribute by sponsoring Leon.

Thanks

OpenAI logo.OpenAI logo. JetBrains logo.JetBrains logo. MacStadium logo.MacStadium logo.
openai.com/form/codex-for-oss jb.gg/OpenSource macstadium.com/company/opensource

leon (leon-ai/leon)

Searching Database…

17.6K ·GitHub
Что это такое?Leon — это персональный ИИ-ассистент с открытым исходным кодом, который работает локально и построен вокруг инструментов, контекста, памяти и агентного выполнения — он понимает цель, использует настоящие инструменты и доводит задачи до конца.
Это веб-приложение, программа для компьютера или что-то, что я развертываю сам?Это self-hosted набор: сервер на Node.js (среда выполнения, память, HTTP API) плюс веб-приложение, которое открывается в браузере, а часть сервисов в рантайме написана на Python.
Как его запустить?Установите Node.js 24 или новее (рекомендуется Volta), склонируйте репозиторий и запустите Leon — по умолчанию всё работает локально, и вы пользуетесь им через веб-приложение.
Нужно ли что-то ещё, кроме Node.js?Основное требование — Node.js >= 24, но часть стека написана на Python (мосты и некоторые сервисы). Также нужно выбрать ИИ-провайдера — локального или облачного; уже встроена поддержка OpenAI, Anthropic, Groq, Cerebras и других.
Насколько текущая версия стабильна — можно ли на неё полагаться?Пока нет — Leon сейчас находится в статусе 2.0 Developer Preview на ветке develop, и новая документация ещё не готова. Если нужна старая, более стабильная версия до агентных изменений, используйте ветку master.
Всё уходит в облако или может оставаться на моём компьютере?Приватность — заявленная цель проекта: Leon может работать с локальными моделями и локальным контекстом, не прогоняя всё через сторонние сервисы, хотя облачные провайдеры тоже остаются вариантом.
Что он умеет сразу после установки?В репозитории уже есть навыки и тулкиты для поиска, продуктивности, системных утилит, работы с медиа, помощи в программировании, взаимодействий с памятью, а также голосовых и аудиофункций. Нативные навыки выполняют контролируемые действия, а агентные навыки следуют сценариям из SKILL.md.
Как он решает, что делать, — это просто ответы в чате?Есть три режима: умный режим выбирает за вас, контролируемый режим следует детерминированным нативным навыкам и действиям, а агентный режим умеет планировать по шагам. Leon использует настоящие инструменты, а не только отвечает текстом.
Может ли он управлять моим компьютером и браузером?Да — в нём есть подгружаемая по мере необходимости функция computer use, которая может управлять рабочим столом и интерфейсом браузера, проверяя результат визуально; она работает локально или через Satellite, не раскрывая весь набор инструментов посторонним запросам.
Зачем делать ассистент с открытым кодом, когда есть ассистенты от корпораций?В README названы четыре причины: приватность (локальные модели вместо сторонних сервисов), обоснованное поведение (инструменты, контекст и память вместо расплывчатых ответов «голой» модели), расширяемость (навыки, тулкиты, мосты, бинарники) и открытый исходный код.
Creator
leon-ai
Size
38.6 MB
Stars
17.6K
Updated
CommitOct 12
Age
7y
Commits · 90 Days