Freebuff 仓库介绍

Freebuff 概览

Freebuff 提供五款免费的 AI 产品，涵盖编码、构建与研究场景，无需订阅、积分或 API 密钥。通过文本广告的形式支撑所包含模型的访问成本。

产品矩阵

快速上手

npm install -g freebuff    # 全局安装 CLI
cd ~/my-project             # 进入项目目录
freebuff                    # 启动 Freebuff

随后描述需求即可。Freebuff 会自动定位相关文件、进行修改，并运行项目所需的关键检查。

模型目录

Freebuff 内置精选模型目录，主选择器当前提供以下模型：

需要注意的临时措施：V4 Flash 使用高级会话而非无限调用；DeepSeek 系列可能以 Q8_0 量化版本运行以降低成本；MiMo 2.5 期间不限量。这些策略后续将被还原。

主选择器之外还存在两类模型：GLM 5.2 通过累计会话获取，不作为常驻解锁项；Gemini 3.1 Flash Lite 专门用于文件检索、研究等专业任务，不出现在主选择器中。此外，Freebuff Desktop 可调用本机已安装的 Claude Code 与 Codex Agent，复用用户现有账号，与 Freebuff 内置目录相互独立。

工作机制

Freebuff 采用多 Agent 协作架构，而非单一模型加单一提示词的简单模式。根据任务类型，Agent 会执行上下文收集、规划、编辑或调研、工具调用、结果复核等环节。

• 代码库上下文：文件检索 Agent 在编辑前绘制项目相关结构图。
• 实现与审查：Agent 可分工协作，执行修改、运行命令并检查结果。
• 研究与浏览器使用：Agent 可查阅文档，并在真实浏览器中测试应用。
• 本地并行：Desktop 将并发 Agent 隔离到独立工作区。
• 托管环境：Web 与 Cloud 提供沙箱、预览、终端与部署流水线。

免费访问与数据使用

Freebuff 在所有国家可用。覆盖区域享有完整访问权限；其他地区及 VPN 用户进入有限模式，目前为 MiMo 2.5，每天三次、每次一小时的会话，最多可累积至七次。文本广告支撑模型成本，启动前 Freebuff 会展示会话上限及模型相关的数据使用说明。

数据训练方面：仅当模型或特性明确说明数据可能用于训练时，Freebuff 或上游提供方才可能保留提交内容，以开发、训练、测试、评估、微调与改进模型或产品。提示词、消息、代码、文件与仓库数据用于提供服务，可能被分析（含粘贴内容）以实现广告个性化；独立上传与已连接仓库不会提供给广告方。法律要求的地区提供广告选择并尊重退出信号。

二次开发

Freebuff 是基于 Bun 构建的 TypeScript monorepo，欢迎针对产品、Agent、工具、文档与底层运行时的贡献。本地开发依赖 Docker 与 .env.local 配置，启动服务前需阅读贡献指南。

git clone https://github.com/CodebuffAI/freebuff.git
cd freebuff
bun install
bun up            # 启动核心服务
bun start-cli     # 单独启动 CLI

提交 Pull Request 前，应参考贡献指南、开发指南与测试指南完成环境配置与必要检查。

技术底座

Freebuff 构建于开源多 Agent 框架 Codebuff 之上，由其提供编排、工具与 SDK。若需定制 Agent 或将其嵌入其他应用，可查阅 Codebuff 文档与 @codebuff/sdk 软件包。