floom

AI 智能体的生产层。 将 Python 脚本部署为云自动化任务，并提供可共享的 Web UI、REST API 和 MCP 端点。无需 Docker，无需基础设施，无需 YAML。

告诉你的 AI 智能体“deploy on floom”，你的脚本几秒钟内即可上线。

floom 的功能

你编写一个 Python 脚本，floom 会将其转化为：

• 一个带有类型化输入和输出的 Web UI，任何人都可以使用

• 一个其他服务可以调用的 REST API

• 一个 AI 智能体可以发现的 MCP 端点

• 托管的密钥、版本历史记录和定时任务

无需 Docker。无需 CI/CD。无需基础设施。只需输入 Python，即可获得生产环境应用。

适用人群

• 开发者：构建 Python 自动化工具并需要与非技术人员共享时

• AI 代理机构：为客户部署工具时

• 任何使用 Claude Code 或 Cursor 的用户：希望从本地开发环境即时部署到生产环境时

快速入门

安装 Claude Code 技能

git clone https://github.com/floomhq/floom.git ~/tmp/floom && ~/tmp/floom/scripts/setup

部署你的第一个脚本

1. 在 Claude Code 中输入 /floom

2. 指向任何 Python 脚本

3. 它会自动适配、在沙箱中测试并部署

4. 你将获得一个可共享的实时 URL

或者告诉任何支持 MCP 的智能体：“deploy this on floom”

从零开始编写脚本

import os
from google import genai

def run(url: str) -> dict:
    client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
    response = client.models.generate_content(
        model="gemini-2.0-flash",
        contents=f"Summarize the company at {url} in 3 sentences."
    )
    return {"summary": response.text}

就是这样。floom 处理剩下的所有工作：沙箱测试、部署、UI 生成、密钥注入。

工作原理

1. 编写一个带有 run() 函数的 Python 脚本

2. 通过 Claude Code (/floom)、Cursor 或任何支持 MCP 的智能体进行部署

3. 测试会在 E2B 沙箱（欧盟托管，SOC 2 认证）中自动运行

4. 共享实时 URL 给任何人

查看 BUILDING.md 获取完整协议：清单格式、输入/输出类型、API 参考。

API

所有端点位于 dashboard.floom.dev/api/。完整参考请见 BUILDING.md。

# Upload code
curl -X POST https://dashboard.floom.dev/api/artifacts \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"code": "def run(x): return {\"result\": x}", "manifest": {...}}'

# Test in sandbox
curl -X POST https://dashboard.floom.dev/api/test \
  -d '{"artifactId": "...", "inputs": {"x": "hello"}}'

# Deploy
curl -X POST https://dashboard.floom.dev/api/deploy \
  -d '{"artifactId": "..."}'

功能特性

对比

技术栈

• 运行时: E2B 沙箱（欧盟托管，SOC 2 Type II 认证）

• 后端: Convex

• 身份验证: Clerk

• 存储: Cloudflare R2

• 前端: Vercel 上的 Next.js

链接

• 仪表盘: dashboard.floom.dev

• 文档: docs.floom.dev

• 协议参考: BUILDING.md

常见问题

什么是 floom？

floom 是 AI 智能体的生产层。你编写一个 Python 脚本，floom 会将其转化为带有可共享 Web UI、REST API 和 MCP 端点的云自动化任务。无需 Docker，无需基础设施，无需 YAML。告诉你的 AI 智能体“deploy on floom”，你的脚本几秒钟内即可上线。

floom 与 n8n、Zapier 或 Make 有什么不同？

n8n、Zapier 和 Make 是可视化工作流构建器，你需要在 GUI 中连接节点。floom 是代码优先的：你编写一个 Python 函数，平台会自动生成 UI、API 和基础设施。没有拖拽编辑器。你从终端或 AI 智能体进行部署，非技术团队成员使用生成的 Web UI 来运行它。

floom 与 Vercel 或 Modal 有什么不同？

Vercel 部署完整的 Web 应用。Modal 部署 Python 函数，但需要使用他们的 SDK 和装饰器。floom 部署单个 Python run() 函数，并自动生成带有类型化输入和输出的 Web UI，因此你的团队中任何人都可以使用它，而无需编写代码或调用 API。

floom 支持 Claude Code 吗？

支持。使用 git clone https://github.com/floomhq/floom.git ~/tmp/floom && ~/tmp/floom/scripts/setup 安装技能，然后在 Claude Code 中输入 /floom。它会适配你的脚本，在沙箱中测试并部署。

floom 支持 Cursor、Windsurf 或其他 AI 智能体吗？

支持。任何支持 MCP 的智能体都可以部署到 floom。该协议是一个标准的 REST API：上传代码 + 清单，测试，部署。查看 BUILDING.md 获取完整 API 参考。

我的数据安全吗？

代码在 E2B 沙箱中运行，该沙箱在欧盟托管并获得 SOC 2 Type II 认证。每次运行都会获得一个隔离的沙箱，执行后即销毁。密钥在静态存储时加密，并在运行时注入，绝不会暴露在日志或 UI 中。

费用是多少？

floom 可以免费开始使用。查看 dashboard.floom.dev 获取当前定价详情。

floom 支持哪些语言？

Python。你的脚本需要一个 run() 函数，该函数接收类型化参数并返回一个字典。依赖项会根据清单自动通过 pip 安装。

我可以定时执行自动化任务吗？

可以。在你的清单中添加一个 schedule 字段（cron 语法）。例如，"schedule": "0 9 * * 1" 会在每周一上午 9 点运行。你还可以设置 scheduleInputs，为定时运行提供默认值。

我可以上传文件（PDF、CSV、Excel）吗？

可以。在你的清单中使用 file 输入类型。用户通过 Web UI 上传文件，你的 run() 函数会收到一个 R2 URL 字符串。在函数内部使用 requests.get() 或 httpx.get() 下载它。

许可证

开源。详情请见 LICENSE。