wehub/leon-ai--leon
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity
Files
main
leon-ai--leon/README.md
T
wehub-resource-sync d95e660ed1 docs: make Chinese README the default
2026-07-13 10:42:59 +00:00

8.4 KiB
Raw Permalink Blame History

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

Leon
Leon

你的开源个人 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 当前状态最准确的高层参考是：

👋 简介

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 >= 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: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 了解 Leon 当前的身份与行为
  • 使用 core/context/ARCHITECTURE.md 了解当前架构概览
  • 在更新后的文档发布之前，公开文档站点预计会滞后于新核心

❤️ 参与贡献

我们正在逐步为 2.0 Developer Preview 引入贡献者。

如果你想关注该项目或表达加入该引导流程的意向：

为什么贡献者数量较少？

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

长期以来，Leon 是一个架构更简单的小型助手项目。如今，核心正在围绕工具、记忆、上下文和智能体式执行重建为能力更强的系统。这意味着许多内容仍在变动，在全新文档和架构稳定下来之前，参与贡献会比之后更加困难。

另一个重要原因仅仅是时间：Leon 的开发仍主要在业余时间进行。因此进展可能不均衡，在 2.0 Developer Preview 仍在成形之际，更广泛地开放项目必须与保持方向连贯性之间取得平衡。

📖 Leon 背后的故事

Leon 始于 2017 年，自 2019 年以来一直活跃。如果你想了解更完整的故事，请阅读 Leon 背后的故事.

🔔 保持关注

👨 作者

Louis Grenard (@grenlouis)

👍 赞助商

你也可以通过赞助 Leon. 来参与贡献

致谢

OpenAI logo.OpenAI logo. JetBrains logo.JetBrains logo. MacStadium logo.MacStadium logo.
openai.com/form/codex-for-oss jb.gg/OpenSource macstadium.com/company/opensource
Reference in New Issue View Git Blame Copy Permalink