# forgent3d

**Repository Path**: cellinlab/forgent3d

## Basic Information

- **Project Name**: forgent3d
- **Description**: Using AI to generate 3D models
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-26
- **Last Updated**: 2026-05-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="assets/images/logo.png" width="96" alt="Forgent3D logo" />
</p>

<h1 align="center">Forgent3D</h1>

<p align="center">
  <strong>代码就是模型</strong>
</p>

<p align="center">
  <a href="https://github.com/forgent3d/forgent3d/releases">
    <img alt="Release" src="https://img.shields.io/github/v/release/forgent3d/forgent3d?style=flat-square&logo=github" />
  </a>
  <img alt="GitHub stars" src="https://img.shields.io/github/stars/forgent3d/forgent3d?style=flat-square&logo=github" />
  <img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green?style=flat-square" />
  <img alt="AI CAD" src="https://img.shields.io/badge/AI%20CAD-local%20agent-6E56CF?style=flat-square" />
  <img alt="Parametric modeling" src="https://img.shields.io/badge/parametric-modeling-0F766E?style=flat-square" />
  <br />
  <img alt="Electron" src="https://img.shields.io/badge/Electron-20232A?style=flat-square&logo=electron&logoColor=9FEAF9" />
  <img alt="Three.js" src="https://img.shields.io/badge/Three.js-black?style=flat-square&logo=three.js&logoColor=white" />
  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white" />
  <img alt="Python" src="https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white" />
  <img alt="build123d" src="https://img.shields.io/badge/build123d-CAD%20kernel-455A64?style=flat-square" />
  <img alt="MuJoCo" src="https://img.shields.io/badge/MuJoCo-simulation-8B5CF6?style=flat-square" />
  <img alt="MCP" src="https://img.shields.io/badge/MCP-agent%20tools-111827?style=flat-square" />
  <img alt="pnpm" src="https://img.shields.io/badge/pnpm-F69220?style=flat-square&logo=pnpm&logoColor=white" />
</p>

<p align="center">
  <a href="README.md">English</a>
  ·
  <a href="#-核心思路">核心思路</a>
  ·
  <a href="#-快速开?>快速开?/a>
  ·
  <a href="https://github.com/forgent3d/forgent3d/releases">下载</a>
</p>

Forgent3D 是一个将大语言模型（LLM）生成的代码转化为三维模型，并进行实时预览的桌面工具（基?Electron）。你可以?AI 编程助手生成或修改参数化 CAD 代码，再通过 Forgent3D 立即查看真实?3D 几何结果?

![Forgent3D 参数化模型与 3D 预览](docs/forgent3d-preview.webp)

## ?核心思路

打破传统的建模门槛，底层内核基于强大?**build123d**，你可以自然地结?**Cursor**?*Claude**?*Code** ?**Codex** ?AI 编程助手来生成和编写模型代码。Forgent3D 负责将这些代码即时渲染，让你直观地看到最终的 3D 效果?

- **参数?CAD**：模型由 `part.py` ?`asm.xml` ?`params.json` 驱动，尺寸和视觉参数都可以持续编辑?
- **本地实时预览**：重建模型后直接?Three.js 预览器中检查几何效果?
- **适合 AI Agent**：内置项目技能和 MCP 工具，方?Agent 生成、重建、截图和验证模型?
- **几何优先验证**：单体零件可通过 BREP 预览，并提供面和包围盒信息用于检查?
- **装配与运?*：支?MJCF 多体装配、STL 网格、关节、约束和可?MuJoCo 仿真?

## 🚀 快速开?

最新版本下载地址?[https://github.com/forgent3d/forgent3d/releases/](https://github.com/forgent3d/forgent3d/releases/)

或者从源码运行?

```bash
pnpm install
npm run build:runner
npm run dev
```

应用会创建一个包?`parts/` / `assemblies/` 的项目目录。每个模型都有独立文件夹，里面保存源码和参数?

```text
parts/
  bracket/
    part.py
    params.json
assemblies/
  linkage_demo/
    asm.xml
    params.json
```

## 🧩 工作方式

```text
AI Agent 或编辑器
        |
        v
parts/<name>/part.py or assemblies/<name>/asm.xml
adjacent params.json
        |
        v
Forgent3D build runner
        |
        v
BREP 零件预览?MJCF 装配预览
        |
        v
交互式查看器、截图、几何信息、MCP 反馈
```

## 🤖 AI Agent 工作?

Forgent3D 适合?AI 编程工具放在一起使用。你可以从查看器启动 Agent，让项目技能、规则和 MCP 配置自动可用?

典型流程?

1. ?Agent 创建或修改模型?
2. Agent 编辑 `part.py`、`asm.xml` ?`params.json`?
3. Agent 调用查看器的重建工具?
4. Forgent3D 更新预览并缓存几何信息?
5. Agent 使用截图或包围盒数据验证结果?

这样可以?AI CAD 工作流落在真实几何上，而不是只停留在文本推理里?

## 🛠?开?

```bash
pnpm install
npm run build:runner
npm run dev
```

常用脚本?

```bash
npm run build:renderer
npm run build
npm run start
```

## 📄 协议

本项目采?[MIT](LICENSE) 协议开源?