Leon

你的开源个人 AI 助手。

在 X / @grenlouis 上关注开发动态

官网 :: 旧版文档 :: 路线图 :: 贡献指南 :: 项目故事

---

⚠️ 重要通知（截至 2026-03-29）

[!IMPORTANT] Leon 目前专注于 develop 分支上的 2.0 开发者预览版 (2.0 Developer Preview)。

• 新文档 尚未准备好。
• 当前文档站点和旧指南主要反映的是遗留架构 (legacy architecture)。
• 如果你想要更稳定、非代理式的旧版 Leon，请使用 master 分支。
• 如果你想探索或为 Leon 的新核心做出贡献，develop 是正确的选择。

关于 Leon 当前状态最准确的高级参考是：

• core/context/LEON.md
• core/context/ARCHITECTURE.md

👋 简介

Leon 是 你的开源个人 AI 助手 (AI Assistant)，围绕工具 (Tools)、上下文 (Context)、记忆 (Memory) 和代理式执行 (Agentic Execution) 构建。

Leon 旨在保持实用、注重隐私感知 (Privacy-aware)，并扎根于你的真实环境。它可以在本地运行，使用专用工具而不是依赖自由形式的猜测，并在确定性工作流 (Deterministic Workflows) 和代理式执行中从头到尾完成任务。

🧠 Leon 的现状

Leon 不再仅仅像 2019 年首次发布时那样是一个经典的意图分类 (Intent-Classification) 助手。

如今，Leon 正在被构建为一个更有能力的助手，它能够理解目标、选择处理方式、使用工具、记住有用信息，并在出现问题时进行恢复。

• Leon 可以根据任务以不同方式运行：smart 模式为你选择，workflow 模式遵循固定路径，而 agent 模式可以逐步规划。
• Leon 可以使用真实工具来完成任务，而不仅仅是回复纯文本。
• Leon 可以利用关于你环境的上下文信息，使答案扎根于你的机器和设置上实际发生的事情。
• Leon 保持分层记忆，以便它可以记住持久偏好、日常上下文和最近的讨论上下文。
• Leon 支持本地和远程 AI 提供商，这有助于平衡隐私、控制和能力。
• 在底层，核心组织为 Skills -> Actions -> Tools -> Functions (-> Binaries)。

Leon 还保持紧凑的自我模型 (Self-Model) 和有界的主动脉冲系统 (Bounded Proactive Pulse System)，以便它在一段时间内保持一致，而不会被不必要的上下文淹没。

为什么？

• 隐私很重要：Leon 可以与本地模型 (Local Models) 和本地上下文一起工作，而不是强制所有操作都通过第三方服务 (Third-party Services)。
• 行为的落地性很重要：Leon 更喜欢明确的工具、上下文和记忆，而不是模糊的仅基于模型的响应。
• 可扩展性很重要：技能 (Skills)、工具包 (Toolkits)、桥接 (Bridges) 和二进制文件 (Binaries) 使得保持 Leon 模块化成为可能。
• 开源很重要：任何人都可以检查架构，在其之上构建，并帮助塑造其下一步方向。

🚀 入门指南

前置条件

• Node.js >= 24.0.0
• 支持的操作系统：Linux, macOS, 和 Windows

推荐：使用 Volta 管理 Node.js。

安装

# 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

运行 Leon

# Run Leon
pnpm start

检查你的设置

# Check the setup went well
pnpm run check

默认情况下，Leon 在本地运行，应用程序可在 http://localhost:1337 访问。

🏗️ 架构快照

在高级层面，Leon 目前由以下部分组成：

• server/: 主运行时、路由、内存、上下文管理、HTTP API 以及代理/工作流执行
• app/: Web 应用程序
• aurora/: UI 组件和预览环境
• skills/: 基于核心构建的用户可见功能
• bridges/: Node.js 和 Python 桥接以及工具包定义和工具运行时
• tcp_server/: 运行时堆栈部分使用的 Python 服务
• core/context/: 生成的身份和架构上下文文档，描述 Leon 的当前行为

该仓库已经包含了搜索、生产力、系统工具、媒体工作流、编码辅助、基于记忆的交互以及语音/音频功能等领域的技能和工具包。

📚 文档状态

Leon 2.0 的新文档尚未准备好。

目前：

• 将此仓库视为 2.0 开发者预览版 (2.0 Developer Preview) 的权威来源 (Source of Truth)
• 使用 core/context/LEON.md 获取 Leon 当前的身份和行为
• 使用 core/context/ARCHITECTURE.md 获取当前架构概览
• 预期公共文档站点在新核心更新之前会滞后于新核心，直到更新的文档发布

❤️ 贡献指南

我们开始逐步为 2.0 开发者预览版 (2.0 Developer Preview) 招募贡献者。

如果你想关注该项目或表达加入该入职流程的兴趣：

• 2.0 开发者预览版贡献者表单
• 路线图
• Discord
• GitHub issues

为什么贡献者数量较少？

Leon 已经发展了很长时间，但当前的 2.0 工作正处于一个重大转型期。

长期以来，Leon 是一个架构更简单的较小助手项目。如今，核心正在被重构为一个围绕工具（tools）、记忆（memory）、上下文（context）以及代理式执行（agent-style execution）的更强大系统。这意味着许多事情仍在变动中，这使得贡献比新文档和架构稳定后更加困难。

另一个重要原因仅仅是时间问题：Leon 的开发主要仍是在业余时间进行的。因此进度可能不均衡，而在 2.0 开发者预览版（Developer Preview）仍在成型的过程中，扩大项目的开放度必须与保持方向的一致性相平衡。

📖 Leon 背后的故事

Leon 始于 2017 年，自 2019 年起一直活跃至今。如果你想了解更详细的前因后果，请阅读 Leon 背后的故事。

🔔 关注动态

• X / Twitter
• 通讯订阅
• 博客
• YouTube

👨 作者

Louis Grenard (@grenlouis)

👍 赞助者

Appwrite 250 美元/月

匿名 100 美元/月

herbundkraut 10 美元/月

你？

你也可以通过 赞助 Leon 来做出贡献。

Leon 快速上手指南

Leon 是一款开源个人 AI 助手，基于工具、上下文、记忆和智能体执行构建。当前版本专注于 2.0 Developer Preview，支持本地运行与隐私保护。

环境准备

• 操作系统：Linux, macOS, Windows
• 运行时：Node.js >= 24.0.0
• 包管理器：pnpm (推荐通过 Volta 管理 Node.js)
• 分支说明：
  • develop 分支：2.0 开发者预览版（新功能核心）
  • master 分支：旧版稳定架构
  • 注：本文档基于 develop 分支特性编写

安装步骤

# 克隆仓库
git clone https://github.com/leon-ai/leon.git

# 进入项目根目录
cd leon

# 全局安装 pnpm
npm install --global pnpm@latest

# 安装依赖
pnpm install

基本使用

启动 Leon 服务：

pnpm start

服务默认运行在本地，可通过浏览器访问：

http://localhost:1337

完成安装后，建议运行以下命令检查环境配置：

pnpm run check

---

重要提示：

• 新版文档尚未发布，请以仓库内的 core/context/LEON.md 和 core/context/ARCHITECTURE.md 为准。
• Leon 支持本地模型与远程 AI 提供商，可根据需求平衡隐私与控制权。