{"id":49593485,"url":"https://github.com/forgent3d/forgent3d","last_synced_at":"2026-05-24T08:05:15.010Z","repository":{"id":353604720,"uuid":"1218844081","full_name":"forgent3d/forgent3d","owner":"forgent3d","description":"Using AI to generate 3D models","archived":false,"fork":false,"pushed_at":"2026-05-22T09:39:58.000Z","size":4061,"stargazers_count":98,"open_issues_count":0,"forks_count":9,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T14:48:53.633Z","etag":null,"topics":["3d-modeling","ai-agents","ai-cad","build123d","claude-code-cli","codex-cli","cursor-ai","text-to-cad"],"latest_commit_sha":null,"homepage":"https://forgent3d.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/forgent3d.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-23T09:14:29.000Z","updated_at":"2026-05-22T14:32:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/forgent3d/forgent3d","commit_stats":null,"previous_names":["forgent3d/forgent3d"],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/forgent3d/forgent3d","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgent3d%2Fforgent3d","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgent3d%2Fforgent3d/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgent3d%2Fforgent3d/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgent3d%2Fforgent3d/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/forgent3d","download_url":"https://codeload.github.com/forgent3d/forgent3d/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgent3d%2Fforgent3d/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33426014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-modeling","ai-agents","ai-cad","build123d","claude-code-cli","codex-cli","cursor-ai","text-to-cad"],"created_at":"2026-05-04T02:04:47.130Z","updated_at":"2026-05-24T08:05:15.005Z","avatar_url":"https://github.com/forgent3d.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/logo.png\" width=\"96\" alt=\"Forgent3D logo\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eForgent3D\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eA local AI CAD companion for building, previewing, and iterating parametric 3D models with coding agents.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/forgent3d/forgent3d/releases\"\u003e\n    \u003cimg alt=\"Release\" src=\"https://img.shields.io/github/v/release/forgent3d/forgent3d?style=flat-square\u0026logo=github\" /\u003e\n  \u003c/a\u003e\n  \u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/forgent3d/forgent3d?style=flat-square\u0026logo=github\" /\u003e\n  \u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/license-MIT-green?style=flat-square\" /\u003e\n  \u003cimg alt=\"AI CAD\" src=\"https://img.shields.io/badge/AI%20CAD-local%20agent-6E56CF?style=flat-square\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README_zh.md\"\u003e中文\u003c/a\u003e\n  ·\n  \u003ca href=\"#-download\"\u003eDownload\u003c/a\u003e\n  ·\n  \u003ca href=\"#-ai-agent-workflow\"\u003eAI Agent Workflow\u003c/a\u003e\n  ·\n  \u003ca href=\"#-develop-from-source\"\u003eDevelop From Source\u003c/a\u003e\n  ·\n  \u003ca href=\"https://github.com/forgent3d/forgent3d/releases\"\u003eReleases\u003c/a\u003e\n\u003c/p\u003e\n\nForgent3D is an independent project exploring what CAD workflows look like when coding agents can generate, rebuild, inspect, and revise real geometry locally.\n\nDownload the desktop app from Releases. The bundled build includes the CAD runtime, so you can start without setting up Python or build123d manually.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/forgent3d/forgent3d/releases\"\u003e\u003cstrong\u003eDownload Forgent3D\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n### Quadrotor drone\n\n![Forgent3D: parametric quadrotor drone preview](docs/forgent3d-preview.gif)\n\n### Turbofan engine\n\n![Forgent3D: turbofan engine preview](docs/forgent3d-preview2.gif)\n\n## ✨ Why Forgent3D\n\nMost AI-generated CAD workflows stop at source code. Forgent3D closes the loop: it gives agents and humans a fast way to build, preview, inspect, and iterate on real geometry.\n\n- **Parametric CAD by default**: models are driven by `part.py` or `asm.xml` plus `params.json`, so dimensions and visual choices stay editable.\n- **Live local preview**: rebuild models and inspect them in a Three.js viewer without leaving the desktop app.\n- **AI-agent friendly**: built-in project skills and MCP tooling help agents generate, rebuild, screenshot, and verify CAD output.\n- **Geometry-first validation**: model packages preview through MJCF, with screenshots and bounding-box data available for inspection.\n- **Assemblies and motion**: compose multi-body systems with MJCF, reusable STL meshes, joints, constraints, and optional MuJoCo simulation.\n- **Renderer materials**: use `__viewer.materials` in `params.json` to assign preview material presets and colors without mixing styling into geometry.\n\n## 🚀 Download\n\nDownload the latest release:\n\n\u003chttps://github.com/forgent3d/forgent3d/releases/\u003e\n\nThe release app is the recommended way to try Forgent3D. It is packaged with the local CAD runtime and viewer, so you can create and inspect models without preparing a separate CAD development environment.\n\nThe app creates self-contained model packages under `models/`. Each model has a root `asm.xml` and `params.json`, with local editable parts beneath it:\n\n```text\nmodels/\n  reference_mount/\n    asm.xml\n    params.json\n    parts/\n      mounting_plate/\n        part.py\n        params.json\n      fastener_stack/\n        part.py\n        params.json\n```\n\n## 🧩 How It Works\n\n```text\nAI agent or editor\n        |\n        v\nmodels/\u003cname\u003e/asm.xml + params.json\nmodels/\u003cname\u003e/parts/\u003cpart\u003e/part.py + params.json\n        |\n        v\nForgent3D build runner\n        |\n        v\nMJCF model package preview\n        |\n        v\nInteractive viewer, screenshots, geometry info, MCP feedback\n```\n\n## 🤖 AI Agent Workflow\n\nForgent3D is designed to sit next to AI coding tools. Launch your agent from the viewer so project-specific skills, rules, and MCP configuration are available.\n\nA typical loop:\n\n1. Ask the agent to create or modify a model.\n2. The agent edits `part.py`, `asm.xml`, and `params.json`.\n3. The agent calls the viewer rebuild tool.\n4. Forgent3D updates the preview and caches geometry info.\n5. The agent uses screenshots or bounding-box data to verify the result.\n\nThis keeps the workflow grounded in real geometry instead of text-only reasoning.\n\n## 🛠️ Develop From Source\n\nMost users should start with the release app. If you want to work on Forgent3D itself, run it from source with pnpm:\n\n```bash\npnpm install\npnpm run build:electron\npnpm run build:runner\npnpm run dev\n```\n\nBuilding the embedded CAD runner currently requires Python 3.13. You can set `AICAD_PYTHON_BIN` if you want to point the build at a specific Python executable.\n\nUseful scripts:\n\n```bash\npnpm run build:renderer\npnpm run build\npnpm run start\n```\n\n## 🔗 Ecosystem\n\nForgent3D is part of a growing wave of open AI-assisted CAD experiments. Several projects are exploring how language models, code, and CAD geometry can work together.\n\n- [CADAM](https://github.com/Adam-CAD/CADAM) explores browser-based text-to-CAD, with natural language or image input, parametric controls, browser preview, and common export formats.\n- [text-to-cad](https://github.com/earthtojake/text-to-cad) explores CAD skills and workflows for coding agents such as Codex and Claude Code. It is one of the closest projects in spirit to Forgent3D.\n- [ForgeCAD](https://github.com/KoStard/ForgeCAD) explores code-first parametric CAD using JavaScript/TypeScript, with a browser workbench, local CLI, and agent-ready workflows.\n\nForgent3D focuses on the desktop workflow around agent-generated CAD: packaging the CAD runtime, viewer, agent bridge, rebuild loop, and geometry feedback into one installable app.\n\n## 📄 License\n\nThe source code in this repository is available under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforgent3d%2Fforgent3d","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fforgent3d%2Fforgent3d","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforgent3d%2Fforgent3d/lists"}