leon

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?

• Privacy matters: Leon can work with local models and local context instead of forcing everything through third-party services.
• Grounded behavior matters: Leon prefers explicit tools, context, and memory over vague model-only responses.
• Extensibility matters: skills, toolkits, bridges, and binaries make it possible to keep Leon modular.
• Open source matters: anyone can inspect the architecture, build on top of it, and help shape where it goes next.

🚀 Getting Started

Prerequisites

• Node.js >= 24.0.0
• Supported OSes: Linux, macOS, and Windows

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:1337.

🏗️ Architecture Snapshot

At a high level, Leon currently consists of:

• server/: the main runtime, routing, memory, context management, HTTP API, and agent/workflow execution
• app/: the web application
• aurora/: UI components and preview environment
• skills/: user-facing capabilities built on top of the core
• bridges/: Node.js and Python bridges plus toolkit definitions and tool runtimes
• tcp_server/: Python services used by parts of the runtime stack
• core/context/: generated identity and architecture context documents that describe Leon's current behavior

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:

• treat this repository as the source of truth for the 2.0 Developer Preview
• use core/context/LEON.md for Leon's current identity and behavior
• use core/context/ARCHITECTURE.md for the current architecture overview
• expect the public docs site to lag behind the new core until the updated documentation is published

❤️ 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:

• 2.0 Developer Preview contributor form
• Roadmap
• Discord
• GitHub issues

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

• X / Twitter is the main place where I share Leon progress updates
• Newsletter
• Blog
• YouTube

👨 Author

Louis Grenard (@grenlouis)

👍 Sponsors

You can also contribute by sponsoring Leon.