
flue
让 AI 智能体在沙箱里安全动手干活
Flue 是一个用 TypeScript 编写的沙箱智能体框架,核心目标是为 AI 智能体提供安全、隔离的执行环境。它解决的是智能体在真实系统中运行代码、调用工具时可能带来的安全与稳定性问题:通过沙箱机制,让智能体在受限空间内执行任务,避免对宿主环境造成破坏或数据泄露。框架提供智能体运行时、工具调用、沙箱隔离等基础能力,开发者可以基于它快速搭建可执行代码、可操作文件系统或浏览器的智能体应用。其设计强调可组合与可扩展,适合需要让智能体自主完成多步骤任务的场景。项目在 GitHub 上已获得 8000 多星标,属于成长较快的开源项目,社区关注度较高。整体定位偏向基础设施层,帮助开发者把智能体从“聊天”推进到“动手做事”,同时控制风险。
项目数据
使用教程
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- Node.js 运行环境(README 将 Node.js 列为部署目标之一)
- TypeScript 项目环境(框架与示例均为 TypeScript)
- 目标部署平台账号/环境,可选 Cloudflare Workers、GitHub Actions、GitLab CI/CD、Render 等
- 可用的模型访问凭据(示例使用 anthropic/claude-sonnet-4-6)
安装与启动步骤
-
1准备 Node.js 环境
README 仅把 Node.js 列为部署目标之一,请先确认本机已安装 Node.js,README 未给出具体版本要求。
node -v -
2新建智能体文件
按 README 示例在 agents/triage.ts 中编写智能体;文件首行必须是指令 'use agent',否则不会被识别为智能体。
-
3引入运行时能力
从 @flue/runtime 引入 useModel、useSandbox、useSkill、useTool 等 API,用于组合模型、沙箱、技能与工具。
-
4挂载技能与工具
技能以 SKILL.md 形式导入(如 triage、verify),工具从本地 ts 文件导入(如 github.ts 的 openIssue、searchCode)。
-
5按官方文档部署
README 只给出部署入口链接,未提供安装与启动命令;请从官网文档选择 Node.js、Cloudflare Workers、GitHub Actions、GitLab CI/CD 或 Render 完成部署。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
useModel | 是 | 指定智能体使用的模型 | useModel('anthropic/claude-sonnet-4-6') |
useSandbox | 是 | 指定执行沙箱,README 示例为本地沙箱 | useSandbox(local()) |
useSkill | 否 | 注册技能,参数为 SKILL.md 内容 | useSkill(triage) |
useTool | 否 | 注册可调用的工具函数 | useTool(openIssue) |
local(沙箱来源) | 是 | 本地沙箱,从 @flue/runtime/node 导入 | import { local } from '@flue/runtime/node' |
如何确认成功
README 未提供启动命令与验证方式,请按官网 flueframework.com/docs 对应部署文档确认运行状态。
常见问题
Q:Flue 能在哪些环境运行?
A:README 的 Deploy Anywhere 列出 Node.js、Cloudflare Workers、GitHub Actions、GitLab CI/CD、Render,沙箱侧另提到 Daytona。
Q:智能体如何获得隔离执行环境?
A:通过 useSandbox 组合沙箱,README 示例使用本地沙箱 local(),并说明可用虚拟、本地或远程容器沙箱。
Q:怎么给智能体加工具和技能?
A:用 useTool 注册工具函数(如 openIssue、searchCode),用 useSkill 注册 SKILL.md 技能文件。
Q:有安装命令吗?
A:README 节选中没有给出 npm/pip 等安装命令,请到官网 https://www.flueframework.com 的文档页查看。
注意事项
- README 未提供依赖安装、启动命令、端口与路径信息,请以官网文档为准。
- 智能体文件必须包含 'use agent' 指令,这是被识别为智能体的前提。
- 技能以 SKILL.md 文件形式导入,工具以 .ts 文件形式导入。
- 模型名称、沙箱类型等取值来自 README 示例,实际可选值需查阅官方文档。
核心亮点
- 提供沙箱隔离执行环境,智能体跑代码、调工具不会污染宿主系统
- TypeScript 编写,对前端/Node 开发者友好,类型支持完善
- 框架抽象清晰,便于组合工具与运行时,快速搭建多步骤智能体
不足之处
- 项目较新,生态和周边工具链尚在早期,生产级案例有限
- 沙箱能力依赖底层实现,跨平台或复杂权限场景可能需要额外适配
适用场景
- 让智能体自动执行数据分析脚本并返回结果
- 构建可操作文件系统的自动化助手
- 在隔离环境中运行用户提交的代码或工具调用
替代项目
E2B、OpenHands
项目介绍
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工,交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
agent-manager
开源
一站式管理企业 AI 代理,部署治理全搞定
WSO2 AI Agent Manager is an open control plane designed for enterprises to deploy, m···