flue

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

开源 🏷️定价信息待确认 ✅ 目前可打开 智能体 🍴 复刻 524 🐛 待处理 60 👀 关注 24
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 8591
维护状态 较活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

flue 项目界面预览图
图片来源:项目官网

项目数据

分类智能体
开发团队withastro
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议Apache-2.0
主要语言TypeScript
GitHub 星标★ 8591
上线时间2026-02-07 00:00:00
代码更新2026-10-17
仓库体积18.6 MB
本站数据更新2026-11-04
维护状态较活跃
收录时间2026-09-13
浏览次数1

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-13 · 当前星标 ★ 8591

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:进阶 约 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

同类项目推荐

ScienceClaw 开源

给科学家的自进化AI助手,零幻觉查文献做分析

Verifiable program-level self-evolution for AI-for-Science agents: Skills and typed ···

★ 1024 2026-08-09
kody 开源

把 AI 助手的记忆和钥匙随身带,跨平台无缝切换

The cloud for your team's agents. Save your agent memory, credentials, code, and aut···

★ 903 2026-08-09
Auto-Deep-Research 开源

输入主题,自动生成带引用的深度研究报告,省去手动调研。

"Your Fully-Automated Personal AI Assistant"

★ 1756 2026-08-09
xiaobei 开源

让自媒体获客全自动,一人也能高效接单

为OPC/中小微企业量身打造的自媒体获客智能体

★ 8684 2026-08-10
ai-jail 开源

给 AI 智能体套上沙箱,跑代码不毁机器

Multi-OS sandbox to run AI agents with better constraints (it is not 100% secure, bu···

★ 1447 2026-10-11
redel 开源

让AI智能体像细胞一样分裂,递归协作解决复杂任务

ReDel is a toolkit for researchers and developers to build, iterate on, and analyze ···

★ 96 2026-08-09
GenAI_Agents 开源

50+实战教程,从聊天机器人到多智能体系统,快速上手 AI 智能体开发。

50+ tutorials and implementations for Generative AI Agent techniques, from basic con···

★ 24816 2026-08-09
toolsdk-mcp-registry 开源

一站式查找并接入MCP服务器,结构化配置即拿即用。

MCPSDK.dev(ToolSDK.ai)'s Awesome MCP Servers and Packages Registry and Database with···

★ 213 2026-08-09
metaharness 开源

一键生成带品牌、记忆和签名的专属AI智能体框架

️ The meta-harness for AI agents — scaffold your own focused, branded agent harnes···

★ 736 2026-08-09