xenaarch-dev/forgeos
GitHub: xenaarch-dev/forgeos
一个多 Agent 协作的自主 AI 产品工厂，输入一句话即可自动生成并部署完整的 SaaS 应用。
Stars: 1 | Forks: 0
# ForgeOS
只需一句话。三十分钟后，生产级 SaaS 即可部署。
## 已交付内容
**ContractForge** — [contractforge.co.in](https://contractforge.co.in)
为印度自由职业者提供的 AI 合同生成服务。符合 GST 合规要求与 DPDP Act 2023。每份合同 ₹1,499 或每月 ₹2,499。
即时生成，在《印度合同法 1872》(Indian Contract Act 1872) 下具备法律效力。默认管辖区为孟买。
完全由 ForgeOS 构建：
```
PYTHONPATH=. python3 orchestrator.py \
--idea "AI contract generator for Indian freelancers, GST-compliant, INR pricing"
```
## 系统架构
18 个阶段。10 个阻断关卡。7 个 agent。
| Agent | 名称 | 功能 |
|-------|------|-------------|
| PMAgent | Maya | 需求验证 —— 在编写代码前决定是否推进 |
| ArchitectAgent | Aria | SPEC.md, ARCH.md, TASKS.json, STACK.json |
| ScaffoldAgent | Rex | 完整项目树、配置、Supabase schema |
| SecurityAgent | Marcus | OWASP 审计、RLS 策略、SECURITY.md |
| EvalAgent | Nova | 综合质量评分 —— 低于 80 分则阻断 pipeline |
| LegalAgent | Lexi | 印度特定条款、GST 合规 |
| DeployAgent | Kira | GitHub repo、Render API、Vercel 前端 |
关卡在 agent 之间运行，失败时阻断 pipeline。绝不静默降级。
## Daemon 模式
`ForgeOS_Daemon_Drain` 通过 Windows Task Scheduler 每 15 分钟运行一次。
采用扁平化文件 JSON 队列，位于 `queue/pending/`。drainer 会提取排队中的任务，检查
自动部署守卫（IST 时间 22:00 后不部署），并按顺序处理。
决策记录：[ADR-001](docs/adr/ADR-001-daemon-mode.md)。
## 技术栈
| 层级 | 技术 |
|-------|-----------|
| Frontend | Next.js 14 App Router + TypeScript + Tailwind |
| Backend | FastAPI · Python 3.12 |
| Database | Supabase — Postgres + Auth + RLS |
| Payments | Lemon Squeezy |
| Deploy | Render (后端) · Vercel (前端) |
| Secrets | Doppler |
| 本地推理 | Ollama `qwen2.5-coder:7b` · RTX 4050 |
| Agent 框架 | ForgeADK (本仓库) |
## 测试
**244 / 244 通过。**
- A 组：12 —— 核心模型，LLM 路由
- B 组：199 —— agent pipeline、关卡、工具
- C 组：33 —— 系统测试、daemon
## Night Forge 设计系统
| Token | 值 | 用途 |
|-------|-------|-----|
| `void-black` | `#07050F` | 背景 |
| `teal` | `#00E5CC` | 主要强调色、CTA |
| `gold` | `#E8961F` | 价格、警告 |
| `violet` | `#7C3AED` | 次要强调色 |
| 标题 | Cormorant Garamond | 展示 |
| 等宽 | Space Mono | 代码、数据 |
## 印度优先
不是默认设置 —— 而是每一层都做出的选择。
- 语音合成：`en-IN-NeerjaNeural`
- 合同法：《印度合同法 1872》(Indian Contract Act 1872)
- 税务：GST 18% · SAC 代码
- 管辖区：孟买
- 货币：优先 INR，其次 USD
- 隐私：DPDP Act 2023
## ForgeADK —— 编写 agent
```
from forge_sdk.agent import ForgeAgent
class MyAgent(ForgeAgent):
name = "my_agent"
phase = "build"
capabilities = ["OUTPUT.md"]
requires = ["idea", "spec"]
budget_usd = 0.20
def _execute(self, context: ProjectContext) -> dict[str, Any]:
resp = self._llm(context, "...", purpose="my_task")
self._write(context, "OUTPUT.md", resp.text)
return {"my_agent": "done"}
```
每次 `_llm()` 和 `_write()` 调用都会自动记录 —— 模型、token、成本、构件 (artifact) 大小 ——
记录到 `gbrain-events.jsonl`，并通过 SSE 流式传输到仪表板。
## 快速开始
```
git clone https://github.com/xenaarch-dev/forgeos
cd forgeos
pip install -r requirements.txt
```
将 `.env.example` 复制到 `.env` 并添加你的密钥 —— 最低要求：
`ANTHROPIC_API_KEY`, `SUPABASE_URL`, `SUPABASE_SERVICE_ROLE_KEY`。
```
PYTHONPATH=. python3 orchestrator.py --idea "Your idea here"
```
恢复中断的构建：
```
PYTHONPATH=. python3 orchestrator.py --idea "" --workdir builds/
```
## 环境
```
ANTHROPIC_API_KEY=sk-ant-...
OLLAMA_MODEL=qwen2.5-coder:7b
GITHUB_TOKEN=ghp_...
VERCEL_TOKEN=...
SUPABASE_URL=https://.supabase.co
SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...
SENTRY_DSN=...
LEMON_SQUEEZY_API_KEY=...
```
## License
MIT —— 详见 [LICENSE](LICENSE)。
*ForgeOS · RTX 4050 · WSL2 Ubuntu 22.04 · 每次构建 $0.01–$0.05*
标签：AI工作流, AI智能体, AI风险缓解, DevOps工具, SaaS, 自动化代码生成, 逆向工具