qaml-ai/camelAI

camelAI – 基于 Cloudflare 的持久化 AI 编码工作区

概述 – camelAI 是一个全栈 Web 平台，允许团队与 AI 编码助手进行对话。每个聊天线程在 Cloudflare Durable Object 内运行自己的“编码代理”，为助手提供跨会话持久化的工作区（文件、历史记录、密钥）。

主要功能

• 持久化聊天和项目文件 – 对话和源代码文件存储在基于 Durable Object 的 SQLite 数据库（小文件）和 Cloudflare R2（大文件）中。
• 工作区感知的编码代理 – 代理可以读写项目文件、运行 JavaScript 工具，并在短期的 V8 隔离环境或沙箱容器中执行代码。
• 集成 – 内置 API、数据库、电子邮件、Slack、Discord 等连接器，代理可从聊天中调用。
• 构建与部署 – 项目可在 Docker 支持的沙箱中构建，并发布为 Cloudflare Workers for Platforms，由调度 Worker 路由实时流量。
• 管理功能 – 组织级身份验证、计费、使用配额和应用成本控制策略。

工作原理

1. 前端 – 一个使用 SSR 渲染的 React-Router SPA，由 Cloudflare Worker 提供。
2. 主 Worker – 托管 ChatThreadDO Durable Object，运行代理循环（基于 pi 代理框架）。
3. 工作区 DO – 存储项目的文件系统（SQLite + R2）。
4. 沙箱 Worker – 用于“代码模式”的 V8 隔离环境，以及用于构建、笔记本分析和 SQL 查询的单独 Cloudflare 沙箱容器。
5. 调度器 – 在用户发布的应用程序部署后路由请求。

开始使用

• 需要 Node 22+、Bun、Cloudflare 账户和 Docker（用于沙箱功能）。
• 克隆、使用 bun install 安装、复制示例密钥文件、添加 Cloudflare AI Gateway 令牌（或稍后配置 Anthropic/OpenAI 等），然后运行 bun run dev:local-auth 以使用快速本地开发用户，或运行 bun run dev 以进行完整的 OAuth 流程。

自托管

• 单机 Docker-Compose 设置可以私有运行整个堆栈（Web UI、身份验证、模型提供商、Durable Objects、构建、笔记本、SQL 等）。
• 有意省略电子邮件验证；目标用于内部或评估用途。

适用对象

• 希望获得具有持久状态的 AI 辅助编码环境，并且无需离开平台即可将生成的代码部署为无服务器应用的开发团队。

许可证 – MIT。

---

所有详细信息均直接取自存储库的 README。