项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2445
使用教程
环境要求
- Node.js 24,并使用其自带的 npm 11
- 公开应用无需 PostgreSQL 和 OAuth 提供方即可运行
- 如需启用旧版认证工作区,额外需要 PostgreSQL 和 GitHub OAuth App
安装与启动步骤
-
1准备 Node.js 24
本项目要求 Node.js 24 及其捆绑的 npm 11,请先安装或升级后确认版本。
node -v npm -v -
2克隆项目
从 GitHub 拉取 Fulling 仓库并进入项目根目录。
git clone https://github.com/FullAgent/fulling.git cd fulling -
3安装依赖
使用 npm ci 按锁文件安装全部依赖,保证版本一致。
npm ci -
4启动公开应用
此时以公开模式运行,登录功能处于禁用状态,适合先跑通基础应用。
npm run dev -
5配置认证工作区(可选)
若要体验旧版认证工作区,先复制环境变量模板,并填入数据库、Better Auth 和 GitHub 相关值。
cp .env.template .env.local -
6执行数据库迁移
配置好数据库后运行 Prisma 迁移,创建用户、账号和会话等表。
npm run prisma:migrate -
7再启动完整应用
带着配置重新启动,即可使用 GitHub 登录、数据库工作区和 kubeconfig 流程。
npm run dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
BETTER_AUTH_URL | 是 | Better Auth 的服务地址,用于拼接 GitHub OAuth 回调地址 | https://fulling.example.com |
.env.local 中的数据库配置 | 否 | 仅在启用认证工作区时需要,用于连接 PostgreSQL | postgresql://user:password@localhost:5432/fulling |
.env.local 中的 GitHub OAuth 配置 | 否 | 仅在启用 GitHub 登录时需要,需创建 GitHub OAuth App | github_client_id / github_client_secret |
如何确认成功
运行 npm run dev 后终端输出开发服务器启动日志,浏览器打开其提示的本地地址能正常显示应用页面即成功。
常见问题
Q:只是跑公开应用需要配置数据库和 GitHub OAuth 吗?
A:不需要。公开应用无需任何环境变量即可构建和启动,GitHub 登录、数据库工作区和 kubeconfig 流程在完整旧版配置就位前会保持禁用。
Q:GitHub OAuth 的回调地址怎么填?
A:按 README 填写 ${BETTER_AUTH_URL}/api/auth/callback/github,注意把 ${BETTER_AUTH_URL} 替换为你实际配置的地址。
Q:如何部署到 Vercel?
A:可以直接使用 Vercel 原生的 Next.js 部署,无需 vercel.json;完整步骤、验证方式与回滚流程见 docs/vercel-deployment.md。
Q:替换 v2 部署前要注意什么?
A:先按 docs/v2-resource-inventory.md 清点资源;重置 Fulling 数据库并不会删除 v2 创建的 Kubernetes 资源,需要单独处理。
Q:发布前如何验证 OAuth 配置正确?
A:参考 docs/github-oauth-verification.md 用真实的 OAuth 应用进行验证后再发布。
注意事项
- 仓库刻意不保留旧产品模型和旧认证系统的兼容层,升级时需按新模型配置。
- 当前基础版本中每个用户持有一份明文 kubeconfig,这还不是最终 Workspace Runtime 的所有权模型。
- 认证工作区入口受保护,需要通过 Kubernetes SelfSubjectReview 完成 kubeconfig 校验。
- 目标 Workspace 模型请阅读 docs/architecture.md。
核心亮点
- 深度集成 Claude,能理解复杂需求并生成可运行的全栈代码
- 内置 PostgreSQL + Prisma,自动处理数据库设计和迁移
- 基于 Kubernetes 部署,简化上线运维流程
不足之处
- 依赖 Claude API,使用成本较高
- Kubernetes 配置复杂,对个人开发者上手门槛高
- 文档/社区待观察
适用场景
- 快速搭建 MVP 产品,从零生成全栈应用
- 自动化处理重复性 CRUD 和数据库操作
- 小团队内部工具开发,减少工程配置时间
替代项目
GPT Engineer、Devin、Cursor
下一篇:KiroCrew
同类项目推荐
SE-Agent
开源
让代码代理自我进化,突破局部最优,登顶 SWE-bench。
SE-Agent is a self-evolution framework for LLM Code agents. It enables trajectory-le···
ZorvAI
开源
安卓手机上的开源 AI 助手,能聊能听能定时干活
Zorv AI — 安卓 Android 端开源 AI Agent 智能体助手。多模型对话、人格系统、记忆、语音···
zer0dex
开源
本地双层记忆,跨项目召回更准,消息前自动查询
A local dual-layer memory pattern for AI agents: a compact, human-readable markdown ···
awesome-skills
开源
一键让 AI 变身千种专家,搞定专业任务
1000+ Expert AI Skills | CEO, Doctor, Engineer, Scientist & more | Transform AI into···
nexus-agent
开源
开箱即用的企业级 AI 智能体平台,快速构建可靠问答与自动化流程
企业级 AI 智能体 Agent 平台,覆盖智能对话、文档知识问答、联网搜索、RAG 检索、MCP 工具···
sortie
开源
把工单丢给智能体,自动干活出结果
Turn tracker tickets into autonomous agent sessions
Cerno-Agentic-Local-Deep-Researc···
开源
本地优先的深度研究,推理透明,模型随意切换,数据不出门。
Cerno is a local-first research platform that leverages agentic AI to break down com···
os-june
开源
Mac 上本地运行 AI,聊天、听写、记会议,隐私无忧。
Private AI on your Mac. Chat, dictation, meeting notes, and a local agent in one ope···
codex-chatgpt-bridge
开源
让 Codex 和 ChatGPT 协作写代码,省 token 又安全
A safe bridge for Codex and ChatGPT to hand off coding work, save tokens, and keep l···
