flue

让 AI 智能体在沙箱里安全动手干活

Flue 是一个用 TypeScript 编写的沙箱智能体框架,核心目标是为 AI 智能体提供安全、隔离的执行环境。它解决的是智能体在真实系统中运行代码、调用工具时可能带来的安全与稳定性问题:通过沙箱机制,让智能体在受限空间内执行任务,避免对宿主环境造成破坏或数据泄露。框架提供智能体运行时、工具调用、沙箱隔离等基础能力,开发者可以基于它快速搭建可执行代码、可操作文件系统或浏览器的智能体应用。其设计强调可组合与可扩展,适合需要让智能体自主完成多步骤任务的场景。项目在 GitHub 上已获得 8000 多星标,属于成长较快的开源项目,社区关注度较高。整体定位偏向基础设施层,帮助开发者把智能体从“聊天”推进到“动手做事”,同时控制风险。

开源 unknown 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 8303
维护状态 活跃
是否开源
定价模式 unknown

项目数据

分类智能体
开发团队withastro
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源
开源协议Apache-2.0
主要语言TypeScript
技术栈/模型
GitHub 星标★ 8303
30天Star增速
HF 下载量
上线时间2026-02-07 00:00:00
最近更新2026-09-19 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-09-13
浏览次数0

使用教程

难度:进阶 约 10 分钟 部署方式:库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Node.js 运行环境(README 将 Node.js 列为部署目标之一)
  • TypeScript 项目环境(框架与示例均为 TypeScript)
  • 目标部署平台账号/环境,可选 Cloudflare Workers、GitHub Actions、GitLab CI/CD、Render 等
  • 可用的模型访问凭据(示例使用 anthropic/claude-sonnet-4-6)

安装与启动步骤

  1. 1准备 Node.js 环境

    README 仅把 Node.js 列为部署目标之一,请先确认本机已安装 Node.js,README 未给出具体版本要求。

    node -v
  2. 2新建智能体文件

    按 README 示例在 agents/triage.ts 中编写智能体;文件首行必须是指令 'use agent',否则不会被识别为智能体。

  3. 3引入运行时能力

    从 @flue/runtime 引入 useModel、useSandbox、useSkill、useTool 等 API,用于组合模型、沙箱、技能与工具。

  4. 4挂载技能与工具

    技能以 SKILL.md 形式导入(如 triage、verify),工具从本地 ts 文件导入(如 github.ts 的 openIssue、searchCode)。

  5. 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

项目介绍

flue 是一个智能体领域的开源项目,官方简介:The sandbox agent framework.。项目使用 TypeScript 开发,在 GitHub 上获得 8198 星标。

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 194 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 229933 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187446 2026-08-09
agent-manager 开源

一站式管理企业 AI 代理,部署治理全搞定

WSO2 AI Agent Manager is an open control plane designed for enterprises to deploy, m···

★ 85 2026-08-09