联合创始人 | 早期 Alpha 版本

• 项目 - cofounder.openinterface.ai
• 👋 @n_raidenai

cofounder

• 全栈生成式 Web 应用；后端 + 数据库 + 有状态 Web 应用
• 基于应用架构的生成式 UI，配备 AI 引导的原型设计工具和模块化设计系统

---

早期 Alpha：不稳定 ⚠️

以下几点需特别强调：

• 这是项目的早期、不稳定、预览版。⚠️ 在 v1 发布之前，预计会频繁出现故障。
• 消耗大量 Token。如果你对 Token 使用有限制，请等待 v1 发布后再尝试。
• 再次强调，这是一个早期、不稳定版本。它只是首次测试运行，是对项目理念的初步预览，远未完成。采用开源迭代开发模式，目前仍处于开发中，属于不稳定的早期 Alpha 版本。[等等]

如果以上任何一点对你来说哪怕有一点点影响，请务必等到 v1 发布后再使用！不要尝试当前版本！

为了帮助你判断是否应该尝试当前版本，以下是参考指南：

情况	建议
我不确定这个工具是否已经成熟，也许它无法按预期工作，我可能会白白浪费数百万 Token	不要使用
我对这个工具非常兴奋，希望它能完美地投入生产，否则我就会抱怨“我在 OpenAI API 上花了 X 金额”	不要使用
我对代码不感兴趣。我只想在框里输入文字，让项目自动完成；我不想要杂乱无章、支离破碎的未完成代码	不要使用
我喜欢探索实验性工具，但又有些犹豫。它很可能在中途崩溃，让我很失望	不要使用
那么，现在到底该谁来尝试呢？	没人。不要使用
但我出于某种特殊原因，读完以上内容后仍然很想使用它。	也不要使用

---

https://github.com/user-attachments/assets/cfd09250-d21e-49fc-a29b-fa0c661abfc0

https://github.com/user-attachments/assets/c055f9c4-6bc0-4b11-ba8f-cc9f149387fa

---

重要提示

早期 Alpha 版本；比预期提前了几周

目前仍未集成项目的关键目标功能，主要包括：

• 用于生成项目各个维度的项目迭代模块
• 用于事件流和（更深层次）项目迭代的管理界面
• 完整集成 genUI 插件：
  • 生成式设计系统
  • 部署微调模型并从 api.cofounder 提供服务
• 整个项目范围的本地浏览器开发环境
• 添加 { React Native、Flutter、其他 Web 框架 }
• 验证与众包代码审查及自动修复
• 代码优化
• [...]

请耐心等待 :)

---

使用方法

安装与初始化

• 打开终端并运行

npx @openinterface/cofounder

按照提示操作。安装程序会：

• 提示你输入密钥
• 设置目录并开始安装
• 启动本地 cofounder/api 构建器和服务器
• 打开 Web 控制台，你可以在那里创建新项目（地址为 http://localhost:4200）🎉

注意：
系统会要求你提供 cofounder.openinterface.ai 的密钥。
建议使用该密钥，因为它可以启用设计师/layoutv1 和 swarm/external-apis 功能，
并且在当前的早期 Alpha 期间可无限制使用。

完整索引将在 v1 发布时提供本地下载。

• 目前整个项目使用 node v22。

# 或者，你也可以不通过控制台直接创建新项目，
# 方法是运行：
npx @openinterface/cofounder -p "YourAppProjectName" -d "在这里描述你的应用" -a "(可选) 设计说明"

运行生成的应用

• 你的后端和 vite+react Web 应用将逐步生成在 ./apps/{YourApp} 目录下。打开 ./apps/{YourApp} 中的终端并运行：

npm i && npm run dev

它会在安装依赖后同时启动后端和 vite+react。访问 http://localhost:5173/ 即可打开 Web 应用 🎉

• 在生成的应用内部，你可以使用 ⌘+K / Ctrl+K 来迭代 UI 组件。

[更多细节稍后提供]

注意事项

控制台与本地 API

如果你稍后再继续工作，并希望迭代已生成的应用， 则必须确保本地 ./cofounder/api 服务器正在运行以接收请求。

你可以从 ./cofounder/api 目录下运行以下命令来（重新）启动本地 cofounder API：

npm run start

控制台将会在 http://localhost:4200 打开

• 注意：你也可以在不使用控制台的情况下，直接从同一环境生成新应用，只需在 ./cofounder/api 目录下运行以下命令之一：

  npm run start -- -p "ProjectName" -f "some app description" -a "minimalist and spacious , light theme"
  npm run start -- -p "ProjectName" -f "./example_description.txt" -a "minimalist and spacious , light theme"
  

并发处理

[架构细节将在后续进一步详细说明并记录]

cofounder 架构中的每个“节点”都在 ./cofounder/api/system/structure/nodes/{category}/{name}.yaml 文件中定义了配置，用于处理并发、重试以及每段时间内的限制等问题。

例如，如果你想让多个 LLM 生成任务并行运行（在可能的情况下——序列和并行关系在 DAGS 中定义于 ./cofounder/api/system/structure/sequences/{definition}.yaml 文件中）， 可以前往：

#./cofounder/api/system/structure/nodes/op/llm.yaml
nodes:
 op:LLM::GEN:
  desc: "..."
  in: [model, messages, preparser, parser, query, stream]
  out: [generated, usage]
  queue:
   concurrency: 1 # <------------------------------- 这里 
 op:LLM::VECTORIZE:
  desc: "{texts} -> {vectors}"
  in: [texts]
  out: [vectors, usage]
 mapreduce: true
 op:LLM::VECTORIZE:CHUNK:
  desc: "{texts} -> {vectors}"
  in: [texts]
  out: [vectors, usage]
  queue:
   concurrency: 50

并将 op:LLM::GEN 的 concurrency 参数调整为更高的值。

默认的 LLM 并发设置为 2，这样你可以逐步观察控制台输出的内容——但你可以根据自己的 API 密钥限额适当提高并发数。

---

更改日志

---

路线图

---

基准测试

---

社区与链接

• | 由 @flamecoders 维护的社区 Discord 服务器

---

文档、设计系统等

[开发中]

---

架构

[稍后提供更多详情]

archi/v1 如下：

---

致谢

• 演示设计系统基于以下 Figma 素材/UI 套件构建：
  • Hexa Plugin 的 blocks.pm（参见 cofounder/api/system/presets）
  • Google Material Design
  • Figma 核心组件库
  • shadcn
• 仪表盘采用节点式用户界面，由 react flow 提供支持。

Cofounder 快速上手指南

⚠️ 重要提示：早期 Alpha 版本 当前版本为极早期、不稳定的预览版。代码可能频繁出错，且会消耗大量 API Token。

• 如果您追求生产级稳定性或预算有限，请暂缓使用，等待 v1 正式版发布。
• 本指南仅适用于愿意探索实验性工具、能够接受代码不完整及调试过程的开发者。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 必须使用 Node v22 版本（项目全局依赖此版本）。
• API Keys:
  • 准备好您的 LLM 提供商 API Key（如 OpenAI）。
  • 建议获取 cofounder.openinterface.ai 的访问密钥（Early Alpha 期间可免费无限使用，以启用设计器布局及集群功能）。
• 终端: 支持运行 Shell 命令的终端（Linux/macOS Terminal 或 Windows PowerShell/CMD）。

安装步骤

1. 初始化项目

打开终端，运行以下命令启动安装向导：

npx @openinterface/cofounder

2. 跟随向导配置

安装程序将自动执行以下操作：

• 提示您输入 API Keys。
• 创建必要的目录结构并安装依赖。
• 启动本地 cofounder/api 构建器和服务端。
• 自动在浏览器中打开 Web 仪表盘（默认地址：http://localhost:4200）。

注意：在 Early Alpha 期间，推荐使用 cofounder.openinterface.ai 提供的密钥，以获得完整的设计系统和外部 API 调用功能。完整的本地索引将在 v1 发布时提供下载。

基本使用

您可以通过两种方式创建和运行生成的全栈应用。

方式一：通过 Web 仪表盘（推荐）

1. 访问 http://localhost:4200。
2. 在仪表盘中描述您的需求，创建新项目。
3. 生成完成后，项目代码将位于 ./apps/{YourApp} 目录下。

方式二：通过命令行直接创建

如果您不想使用仪表盘，可以直接通过命令生成项目：

npx @openinterface/cofounder -p "YourAppProjectName" -d "describe your app here" -a "(optional) design instructions"

• -p: 项目名称
• -d: 应用描述
• -a: (可选) 设计风格指令

运行生成的应用

生成完成后，进入项目目录并启动开发服务器：

cd ./apps/{YourApp}
npm i && npm run dev

该命令将并发安装依赖并启动后端服务与 Vite+React 前端服务。

• 访问应用: 打开浏览器访问 http://localhost:5173/ 🎉
• UI 迭代: 在生成的应用界面中，按下 ⌘+K (Mac) 或 Ctrl+K (Windows/Linux) 可对 UI 组件进行即时迭代修改。

恢复开发与本地 API

如果您稍后需要继续迭代已生成的项目，必须确保本地 cofounder/api 服务正在运行。

1. 进入 API 目录：

   cd ./cofounder/api
   

2. 启动服务：

   npm run start
   

3. 仪表盘将再次在 http://localhost:4200 可用。

您也可以在该目录下通过命令行直接生成新应用：

npm run start -- -p "ProjectName" -f "some app description" -a "minimalist and spacious , light theme"

---

注：当前架构允许通过修改 ./cofounder/api/system/structure/nodes/ 下的 YAML 配置文件来调整 LLM 并发数（默认为 2），以适应不同的 API 限额需求。