你的开源个人 AI 助手。
_
我最常在 X / @grenlouis 上分享 Leon 的进展
在 X / @grenlouis 关注进展 · 网站 · Newsletter · 路线图 · 故事
--- ## ⚠️ 重要通知（截至 2026-03-29） > [!IMPORTANT] > Leon 目前专注于 `develop` 分支上的 **2.0 Developer Preview（2.0 开发者预览版）**。 > > - 新文档**尚未就绪**。 > - 当前文档站点和旧版指南大多反映的是旧版架构。 > - 如果你想要旧版、更稳定的非智能体式（pre-agentic）Leon，请使用 `master` 分支。 > - 如果你想探索或参与 Leon 新核心的开发，`develop` 是合适的选择。 关于 Leon 当前状态最准确的高层参考是： - [`core/context/LEON.md`](./core/context/LEON.md) - [`core/context/ARCHITECTURE.md`](./core/context/ARCHITECTURE.md) ## 👋 简介 **Leon** 是一款围绕**工具、上下文、记忆和智能体式执行（agentic execution）**构建的**开源个人 AI 助手**。 Leon 的设计注重实用性、隐私保护，并扎根于你的真实环境。它可以在本地运行，使用专用工具而非依赖自由形式的猜测，并能在确定性工作流和智能体式执行中从头到尾完成任务。 ## 🧠 Leon 如今的定位 Leon 不再像 2019 年首次发布时那样，只是一个经典的意图分类助手。 如今，Leon 正被打造为能力更强的助手，能够理解目标、选择处理方式、使用工具、记住有用信息，并在出现问题时进行恢复。 - Leon 可根据任务以不同方式运行：`smart` 模式会替你选择，`controlled` 模式遵循确定性的原生技能和操作，`agent` 模式可以逐步规划。 - Leon 支持用于受控操作的原生技能，以及用于 `SKILL.md` 支持的工作流的智能体技能。 - Leon 可以使用真实工具完成任务，而不仅限于纯文本回复。 - Leon 可以利用你环境中的上下文，使回答始终立足于你机器和配置上的实际情况。 - Leon 保持分层记忆，能够记住持久偏好、日常上下文以及近期讨论上下文。 - Leon 同时支持本地和远程 AI 提供商，有助于在隐私、控制与能力之间取得平衡。 - 在底层，Leon 原生技能遵循 `Skills -> Actions -> Tools -> Functions (-> Binaries)`。 Leon 还维护紧凑的自我模型和有边界的主动脉冲（proactive pulse）系统，使其能够长期保持一致，而不会用不必要的上下文淹没自身。 ## 为什么？ - **隐私很重要**：Leon 可以使用本地模型和本地上下文，而无需将所有内容强制经由第三方服务。 - **立足现实的行为很重要**：Leon 更倾向于使用明确的工具、上下文和记忆，而非模糊的纯模型回复。 - **可扩展性很重要**：技能、工具包、桥接和二进制组件使 Leon 能够保持模块化。 - **开源很重要**：任何人都可以审查架构、在其基础上构建，并帮助塑造其未来方向。 ## 🚀 快速开始 ### 前置条件 - [Node.js](https://nodejs.org/) >= 24.0.0 - 支持的操作系统：Linux、macOS 和 Windows 推荐：使用 [Volta](https://volta.sh/). 管理 Node.js ### 安装 ```sh # 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 ```sh # Run Leon pnpm start ``` ### 检查你的环境 ```sh # 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 Developer Preview** 的权威来源 - 使用 [`core/context/LEON.md`](./core/context/LEON.md) 了解 Leon 当前的身份与行为 - 使用 [`core/context/ARCHITECTURE.md`](./core/context/ARCHITECTURE.md) 了解当前架构概览 - 在更新后的文档发布之前，公开文档站点预计会滞后于新核心 ## ❤️ 参与贡献 我们正在逐步为 **2.0 Developer Preview** 引入贡献者。 如果你想关注该项目或表达加入该引导流程的意向： - [2.0 Developer Preview 贡献者表单](https://forms.gle/6PCG2D5rYo1q8tKMA) - [路线图](http://roadmap.getleon.ai) - [Discord](https://discord.gg/MNQqqKg) - [GitHub issues](https://github.com/leon-ai/leon/issues) ### 为什么贡献者数量较少？ Leon 已经演进了很长时间，但当前的 2.0 工作正处于重大转型期。 长期以来，Leon 是一个架构更简单的小型助手项目。如今，核心正在围绕工具、记忆、上下文和智能体式执行重建为能力更强的系统。这意味着许多内容仍在变动，在全新文档和架构稳定下来之前，参与贡献会比之后更加困难。 另一个重要原因仅仅是时间：Leon 的开发仍主要在业余时间进行。因此进展可能不均衡，在 2.0 Developer Preview 仍在成形之际，更广泛地开放项目必须与保持方向连贯性之间取得平衡。 ## 📖 Leon 背后的故事 Leon 始于 2017 年，自 2019 年以来一直活跃。如果你想了解更完整的故事，请阅读 [Leon 背后的故事](https://blog.getleon.ai/the-story-behind-leon/). ## 🔔 保持关注 - [X / Twitter](https://x.com/grenlouis) 是我分享 Leon 进展更新的主要渠道 - [Newsletter](https://leonai.substack.com/subscribe) - [Blog](https://blog.getleon.ai) - [YouTube](https://www.youtube.com/channel/UCW6mk6j6nQUzFYY97r47emQ) ## 👨 作者 **Louis Grenard** ([@grenlouis](https://x.com/grenlouis)) ## 👍 赞助商 你也可以通过[赞助 Leon](http://sponsor.getleon.ai). 来参与贡献 ## 致谢 |  |  |  | | --- | --- | --- | | [openai.com/form/codex-for-oss](https://openai.com/form/codex-for-oss/) | [jb.gg/OpenSource](https://jb.gg/OpenSource) | [macstadium.com/company/opensource](https://macstadium.com/company/opensource) |