leon-ai /leon

🧠 Leon is your open-source personal assistant.

★ 17,682⑂ 1,483👁 266⑃ 248● 333▤ 23
TypeScriptMITCreated 2019-02-10getleon.ai
下载:TCP Server 2.0.0tcp-server_v2.0.0 ↓2.0.02026-02-19
+6
日增长
17,682
stars
1,483
forks
266
watchers
248
prs
333
issues
23
releases

README

Leon


你的开源个人 AI 助手。


  🇬🇧 English ·
  🇨🇳 简体中文 ·
  🇫🇷 Français



  
  



  在 X 上关注进展 / @grenlouis ·
  官网 ·
  邮件订阅 ·
  路线图 ·
  背后的故事



---

 [!IMPORTANT]
 我们正在准备首个 Leon 2.0 alpha 版本,届时会带来桌面应用。
 这个版本还没有发布。目前的开发工作都在 develop 分支上,很多地方仍在变化。
 新文档也还没有准备好;公开的文档站和旧指南大多介绍的是上一代版本。

 安装并启动 Leon 后,你已经可以在本地访问
 http://localhost:5366/web-app/,
 提前体验尚未完成的新网页应用。具体步骤在下方。

 2.0 发布前,想说几句话

你好,我是 Louis 👋

我从 2017 年开始开发 Leon,在 2019 年发布了第一个开源版本。之后就一直做到了现在。

最初的想法一直没变。做一个会慢慢了解你、记住你在意的事,并在日常生活中帮上忙的个人 AI 助手。

把人放在中心。 我希望 Leon 是一个温暖、舒服、用心打磨的地方。你可以在这里创造,也可以按照自己的节奏慢慢来。后面会多聊一点我们的理念,不过先来看看怎么体验吧。

 体验预览版

如果你感兴趣,也熟悉从源码运行项目,现在就可以试试我们正在做的东西。

桌面应用计划随首个 2.0 alpha 版本一起发布。在那之前,你可以通过新网页应用先看一看。它还没有准备好,但已经能让你感受到 Leon 正在往哪个方向走。

 安装 Leon

- macOS、Linux 或 Windows
- Node.js = 24

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

 进入项目根目录
cd leon

 安装 pnpm
npm install --global pnpm@latest

 安装依赖
pnpm install

 启动 Leon
pnpm start


- 在 pnpm install 期间按照提示完成配置。
- 打开 http://localhost:5366/web-app/ 体验新网页应用。旧界面仍然可以在 / 访问。
- 运行 pnpm run check 检查安装情况。
- 如果你想使用还没有引入智能体机制的上一代版本,请切换到 master 分支。

 先看一看

Leon 已经有不少能帮上忙的地方了。找一件你确实需要帮助的事交给它,亲自试试,感受一下。

Aurora 是专为 Leon 用心打造的组件库,让交互图表、表单和可视化回答融入你的对话。

Vibes 把窗外的世界带进应用,让背景氛围随着季节、一天中的时段和天气变化。

我只是让 Leon「录制一个新教程,演示如何搜索会话」。下面就是它录好的视频。

https://github.com/user-attachments/assets/90d0880a-7e87-4063-a5bb-09d400da6bc0

下面是一些开发中的界面预览,使用了示例对话和配置页面。点击截图可以查看大图。

| 新网页应用和 Vibes | 任务规划与执行 |
| --- | --- |
|  |  |

| 生成式界面与趋势图 | 生成式界面与柱状图 |
| --- | --- |
|  |  |

| 连接你的工具 | 帮你写点代码 |
| --- | --- |
|  |  |

 为个人 AI 而构建

一个好的模型很重要。围绕它构建的一切也同样重要。Leon 拥有自己的持续智能体循环、在隔离 worker 中执行的工具、渐进式上下文管理和多层记忆。下面是这套设计背后的一些选择。

- 按需加载当前任务需要的内容。 上下文和工具指引会逐步加载,细化到 Leon 此刻需要调用的函数。较大的工具输出保存在结果文件中,较早的对话会在必要时压缩,让工作上下文保持相关和聚焦。
- 让工具有明确的职责和归属。 每个工具都声明自己的函数、设置、依赖和二进制程序。准备和执行过程由明确的代码流程负责,这样下一次需要时,Leon 就可以复用已经准备好的能力。
- 保留可预测的工作流。 原生技能按照明确的动作执行。智能体技能则引导智能体循环处理更灵活的任务。两者使用同一套工具系统。
- 有选择地记住有用的信息。 Leon 保存临时上下文、长期事实与偏好、每日摘要和近期对话记忆,不同配置档案(profile)之间彼此隔离。它会在需要时检索相关记录,也可以查阅原始对话来核实具体细节。
- 行动、观察,并从失败中恢复。 智能体循环根据工具返回的结果决定下一步,检查实际结果,也能在遇到问题时调整并继续。彼此独立的工具调用可以在隔离的 worker 中并行执行。

 了解当前的项目

新文档还在编写中。这些自动生成的上下文文件可以帮助你了解项目,具体实现仍请以源码为准。

- core/context/LEON.md 介绍 Leon 的身份、行为和能力。
- core/context/ARCHITECTURE.md 介绍运行时、记忆、工具、技能和客户端如何协作。

 用实际表现衡量个人 AI

我们希望通过 Leon 推动个人 AI 的前沿发展。在已公开的对比中,Leon 在 WildClawBench 和 PinchBench 所选任务上的综合得分领先。

你可以在 benchmarks.getleon.ai 查看不同维度的结果,以及测试方法和局限。

 理念

我很喜欢做个人 AI。已经花了很多年,也还有好多想尝试的事。同时,我希望我们能享受这个过程。理解自己在做什么。也在屏幕之外,留一点时间给生活。

围绕 AI 的声音已经够嘈杂了。我希望你打开 Leon 时,能感到自在,像回到自己的空间一样,按照自己的节奏慢慢来。这也是我想带给 2.0 的感觉。温暖、舒服,而且能感受到背后的用心。

- 人的手艺依然重要。 我们用 AI 帮助自己构建、学习,提高作品的质量。同时,也花时间理解、做决定、检查结果。我希望我们能为自己给 Leon 带来的东西感到自豪。即使用着 AI 和编程智能体,也依然能保留那些小小的“耶,我做到了!”的时刻。

- 你的个人 AI 应该属于你。 一个很了解你的助手,会保存对你很重要的东西。这是一份责任。Leon 是开源的,可以运行在你自己的机器上,也支持本地和远程模型。使用哪些模型、连接哪些服务,都由你来选择。

- 开源也是人与人之间的事。 分享代码是一部分。帮助别人上手、倾听反馈、解释一个决定、互相学习,也都是。我希望 Leon 成为这样的项目。

- 我们可以花时间,把事情做好。 我希望 Leon 能为你的想法、创造力和身边的人腾出一点空间。我们构建 Leon 的方式也应该如此。一次认真思考后的改进,一场好的交流,一个实用的修复。这些都很重要。

我在《在 Leon AI 2.0 之前,我想说几句话》里聊了更多。

 一起写下接下来的故事

如果你已经关注 Leon 很多年,谢谢你一直都在。如果你

Top issues

Latest release

TCP Server 2.0.0 tcp-server_v2.0.0 Pre-release 2026-02-19
Leon's TCP server to communicate between the core and third-party nodes.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON