Leon
Leon is an open-source personal AI assistant built around tools, context, memory, and agentic execution. It solves the problem of assistants that rely on vague model-only responses by grounding answers in real environment context and using dedicated tools. It is for developers who want a privacy-aware, extensible, and locally runnable AI assistant.
✨ Key features
- Runs locally with support for local and remote AI providers.
- Supports native skills for controlled actions and agent skills for workflows.
- Includes progressively loaded computer use for desktop and browser automation.
- Layered memory for durable preferences, day-to-day context, and recent discussions.
- Modular architecture with skills, toolkits, bridges, and binaries.
- Operates in smart, controlled, and agent modes.
🎯 Use cases
- Build a personal assistant that respects privacy by running locally.
- Automate desktop and browser tasks with visual verification.
- Create custom skills and toolkits for domain-specific workflows.
- Use context about your environment to get grounded answers.
- Develop an agent that can plan and execute multi-step tasks.
📦 Installation
🧰 Requirements: Requires Node.js >= 24.0.0 and a supported OS (Linux, macOS, Windows).
git clone https://github.com/leon-ai/leon.gitcd leonnpm install --global pnpm@latestpnpm install🚀 Usage
# Run Leon
pnpm start
By default, Leon runs locally and the app is available on http://localhost:5366.
⚠️ Good to know
Leon is currently in a 2.0 Developer Preview on the develop branch, with documentation not yet ready and the legacy stable version on the master branch.
❓ FAQ
What is the current status of Leon?
Leon is focused on the 2.0 Developer Preview on the develop branch. The documentation is not ready yet, and the legacy stable version is on the master branch.
How can I run Leon locally?
Clone the repository, install pnpm and dependencies, then run pnpm start. The app will be available at http://localhost:5366.
What are the system requirements?
You need Node.js >= 24.0.0 and a supported OS: Linux, macOS, or Windows.
Where can I find the most accurate documentation?
The repository itself is the source of truth. Refer to core/context/LEON.md for identity and behavior, and core/context/ARCHITECTURE.md for architecture overview.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.