项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4185
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 能执行 make 命令的类 Unix 环境(macOS/Linux 或已安装 make 的 Windows)
- 一个真实可用的 Anthropic API Key(README 要求填入 apps/agent/.env)
- 可访问 Anthropic API 的网络环境
安装与启动步骤
-
1获取项目代码
克隆官方仓库并进入项目根目录,后续所有 make 命令都在此目录执行。
git clone https://github.com/CopilotKit/OpenGenerativeUI.git cd OpenGenerativeUI -
2一键初始化
README 指定的第一条命令,会安装依赖并生成 .env 配置模板文件,耐心等待依赖下载完成。
make setup -
3填入 API Key
编辑 setup 生成的 apps/agent/.env,把模板里的 API Key 换成你自己的真实 Anthropic 密钥,否则 Agent 无法调用模型。
-
4启动全部服务
README 指定的第二条命令,会同时拉起前端与 Agent 服务;终端不要关闭,保持进程运行。
make dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
LLM_MODEL | 否 | 覆盖默认使用的模型,需填入高能力模型 | claude-fable-5 |
apps/agent/.env 中的 Anthropic API Key | 是 | Agent 调用 Claude 模型的凭证,setup 后需手工替换 | sk-ant-xxxxxxxx |
如何确认成功
终端无报错并持续输出服务日志,浏览器打开本地开发地址后能向 Agent 提问并看到生成的 UI 组件(README 未给出具体端口)。
常见问题
Q:生成的界面结构混乱、HTML/SVG 不完整怎么办?
A:README 强调必须使用强能力模型。默认是 Anthropic Claude 的 claude-fable-5,若效果差可在 .env 中用 LLM_MODEL 换成更强模型。
Q:make dev 启动后 Agent 无响应?
A:多半是没填真实 API Key,或填错了模型名。检查 apps/agent/.env 中的 Anthropic 密钥与 LLM_MODEL 是否有效。
Q:生成的代码安全吗?
A:所有生成的可视化内容都渲染在沙箱 iframe 中,并自带明暗主题、渐进显现和响应式尺寸。
Q:能生成哪些类型的内容?
A:算法可视化(二分查找、BFS/DFS、排序)、3D 动画、饼图柱状图与网络图、以及表单/模拟/数学绘图等交互组件。
注意事项
- README 明确要求使用高能力模型,弱模型难以一次生成结构良好的 HTML/SVG。
- 默认模型为 claude-fable-5,可在 .env 中通过 LLM_MODEL 覆盖。
- 务必先填好 apps/agent/.env 再执行 make dev。
- 项目由 CopilotKit 与 LangChain Deep Agents 驱动,属于展示型开源项目。
核心亮点
- 自然语言直接生成 UI 代码,显著提升原型开发效率
- 支持多前端框架适配,方便集成到现有项目
- 内置布局算法和样式系统,生成界面具备基本设计质量
不足之处
- 生成复杂交互和动态逻辑时可能不够准确
- 文档和社区生态尚在建设,可参考案例较少
适用场景
- 快速搭建产品原型或 MVP 界面
- 辅助前端开发,自动生成基础页面代码
- 设计稿到代码的自动转换流程
替代项目
v0、GPT Engineer、Luri
同类项目推荐
SimpleLLMFunc
开源
把 LLM 当函数调用,提示词当代码写,快速集成智能体。
A simple and well-tailored LLM application framework that enables you to seamlessly ···
react-agent-js
开源
用 TypeScript 快速搭出可调试的 ReAct 智能体
PromptHub
开源
一站式管理提示词、技能和智能体,告别碎片化,提升 AI 开发效率。
一款包含了 Prompt管理,Skill管理,Agent管理的一站式AI工具箱,助你高效管理提示词,一键···
geo-optimizer
开源
让内容在 AI 搜索中被引用,Go 实现的可插拔 GEO 框架
A pluggable framework for GEO (Generative Engine Optimization) in Go. Built-in strat···
api2cli
开源
一套模式,让 CLI 同时服务人类和 AI 代理
Audience-aware CLI patterns for Node.js + Commander.js. Build CLIs for humans, AI ag···
pi-session-manager
开源
轻松管理 Pi AI 编程会话,搜索并一键恢复历史记录
Pi session manager for browsing, searching, and resuming Pi AI coding sessions. Rela···
agents
开源
一套标准让多个 AI 编程代理共用技能,少配多干活
Shared standards and reusable skills for Claude Code, Codex CLI, and other AI coding···
instructor-go
开源
用 Go struct 约束大模型输出,直接拿到强类型结果
structured outputs for llms
unigent
开源
用 TypeScript 轻松构建有状态、可回放的 AI 代理工作流。
Build stateful agent workflows with typed outputs, reusable tools, session forks, an···
