leon

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

莱昂

你的开源个人 AI 助理。

我会最常在 X / @grenlouis 分享 Leon 的进展

在 X / @grenlouis 上关注进展 · 网站 · 新闻通讯 · 路线图 · 故事

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

[！重要]
Leon 目前专注于 develop 分支上的 2.0 开发者预览版。

• 新文档尚未准备好。
• 当前的文档网站和旧指南大多反映了旧的架构。
• 如果你想使用Leon的旧版、更稳定的预代理版本，请使用 master 分支。
• 如果你想探索或贡献Leon的新核心，develop 是正确的地方。

Leon当前状态的最准确高层参考是：

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

👋 介绍

Leon 是 你的开源个人 AI 助手，基于 工具、上下文、记忆和自主执行 构建。

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

🧠 今天的 Leon 是什么

Leon 不再只是像2019年首次发布时那样的经典意图分类助手。

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

• Leon 可以根据任务以不同方式运行：smart 模式为你选择，controlled 模式遵循确定性的本地技能和操作，agent 模式可以逐步规划。
• Leon 支持用于受控操作的本地技能和用于 SKILL.md 支持的工作流的代理技能。
• Leon 可以使用真实工具完成工作，而不仅仅是用纯文本回复。
• Leon 包含先进的、逐步加载的计算机使用能力，可操作桌面和浏览器界面、验证视觉结果，并可本地或通过 Satellite 运行，同时不会将其完整工具界面暴露给无关操作。
• Leon 可以利用有关你环境的上下文，使回答保持基于你的机器和设置的实际情况。
• Leon 保持分层记忆，因此可以记住长期偏好、日常上下文和最近的讨论上下文。
• Leon 支持本地和远程 AI 提供者，这有助于平衡隐私、控制和能力。
• 在底层，Leon 原生技能遵循 Skills -> Actions -> Tools -> Functions (-> Binaries)。

Leon 还保持紧凑的自我模型和有限的主动脉冲系统，因此它能够随时间保持更加一致，而不会淹没自己在不必要的上下文中。

为什么？

• 隐私很重要：Leon 可以使用本地模型和本地上下文，而不是将所有内容都通过第三方服务。
• 基础行为很重要：Leon 更喜欢使用明确的工具、上下文和记忆，而不是模糊的仅模型响应。
• 可扩展性很重要：技能、工具包、桥接和二进制文件使得保持 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

跑，利昂

# Run Leon
pnpm start

检查您的设置

# Check the setup went well
pnpm run check

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

🏗️ 架构概览

在高层次上，Leon 目前包括：

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

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

📚 文档状态

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

目前：

• 将此代码库视为 2.0 开发者预览版 的可信来源。
• 使用 core/context/LEON.md 获取 Leon 当前的身份和行为。
• 使用 core/context/ARCHITECTURE.md 获取当前架构概述。
• 在更新文档发布之前，公共文档网站可能落后于新的核心。

❤️ 贡献指南

我们正在逐步为 2.0 开发者预览版 上线贡献者。

如果你想关注项目或表示有兴趣加入该上线：

• 2.0 开发者预览版贡献者表格
• 路线图
• Discord
• GitHub 问题

📖 Leon 背后的故事

Leon 于 2017 年开始，并自 2019 年起活跃。如果你想了解更长的背景故事，请阅读 Leon 背后的故事。

🔔 敬请关注

• X / 推特 是我分享 Leon 进展更新的主要地方
• 新闻通讯
• 博客
• YouTube

👨 作者

路易·格雷纳 (@grenlouis)

感谢