leon

<p align="center">
  <a href="https://getleon.ai"><img width="800" src="https://getleon.ai/img/hero-animation.gif" /></a>
</p>

<h1 align="center">
  <a href="https://getleon.ai"><img width="96" src="https://getleon.ai/img/logo.svg" alt="Leon"></a><br>
  Leon
</h1>

_<p align="center">Your open-source personal AI assistant.</p>_

<p align="center">
  <a href="https://discord.gg/MNQqqKg"><img src="https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white" /></a>
  <a href="https://github.com/leon-ai/leon/blob/develop/LICENSE.md"><img src="https://img.shields.io/badge/License-MIT-1c75db?style=for-the-badge" /></a>
</p>

<p align="center">
  I share Leon progress most regularly on <a href="https://x.com/grenlouis"><strong>X / @grenlouis</strong></a>
</p>

<p align="center">
  <a href="https://x.com/grenlouis">Follow progress on X / @grenlouis</a> ·
  <a href="https://getleon.ai">Website</a> ·
  <a href="https://leonai.substack.com/subscribe">Newsletter</a> ·
  <a href="http://roadmap.getleon.ai">Roadmap</a> ·
  <a href="https://blog.getleon.ai/the-story-behind-leon/">Story</a>
</p>

---

## ⚠️ 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:

- [`core/context/LEON.md`](./core/context/LEON.md)
- [`core/context/ARCHITECTURE.md`](./core/context/ARCHITECTURE.md)

## 👋 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 can run in different ways depending on the task: `smart` mode chooses for you, `controlled` mode follows deterministic native skills and actions, and `agent` mode can plan step by step.
- Leon supports native skills for controlled actions and agent skills for `SKILL.md`-backed workflows.
- Leon can use real tools to get work done instead of only replying with plain text.
- Leon includes advanced, progressively loaded computer use that can operate desktop a