文章摘要
GitHub上的Adam-CAD/CADAM项目页面展示了GitHub平台的功能,包括Copilot、Spark、Models、Advanced Security、Actions、Codespaces、Issues、Code Review、Discussions和Code Search等工具,帮助开发者编写代码、构建应用、管理提示、修复漏洞、自动化工作流程、创建开发环境、跟踪工作、管理代码变更、协作和搜索代码。页面还提供了探索GitHub的链接,如Why GitHub、Documentation、GitHub Skills和Blog。
文章总结
GitHub - Adam-CAD/CADAM 项目简介
CADAM 是一个基于自然语言描述生成参数化3D模型的Web应用程序。该项目的主要功能包括:
- 模型生成:通过文本提示或图像参考生成参数化3D模型,并输出OpenSCAD代码,支持通过交互式滑块即时调整模型尺寸。
- 代码生成与对话:使用独立的代理进行对话和代码生成,简单的参数调整通过正则表达式更新,无需依赖AI。
- 导出与渲染:支持导出为.STL或.SCAD格式,并通过将OpenSCAD编译为WebAssembly,结合Three.js和React Three Fiber在浏览器中进行3D渲染。
- 库支持:支持BOSL、BOSL2和MCAD库,并提供自定义字体(Geist)支持,用于模型中的文本。
环境要求: - Node.js 和 npm - Supabase CLI - ngrok(用于本地Webhook开发)
环境变量设置:
1. 前端环境:复制.env.local.template为.env.local,并更新相关密钥。
2. Supabase函数环境:复制supabase/functions/.env.template为supabase/functions/.env,并更新相关密钥,包括Anthropic API密钥和ngrok URL。
ngrok设置:
1. 安装ngrok并启动隧道,指向Supabase实例。
2. 将生成的ngrok URL添加到supabase/functions/.env文件中。
开发流程:
1. 安装依赖:npm i
2. 启动Supabase服务:npx supabase start 和 npx supabase functions serve --no-verify-jwt
项目依赖: - OpenSCAD - openscad-wasm - openscad-playground - openscad-web-gui - dingcad
许可证:
该项目采用GNU通用公共许可证v3.0(GPLv3),部分代码来源于openscad-web-gui(GPLv3),并包含OpenSCAD WASM的未修改二进制文件(GPL v2或更高版本)。
项目资源: - 项目主页:adam.new/cadam - 许可证:GPL-3.0 license
贡献者: - tsadpbb - ForzaAaRon - zachdive
语言分布: - TypeScript: 92.8% - CSS: 4.2% - PLpgSQL: 1.6% - JavaScript: 1.3% - HTML: 0.1%
该项目通过自然语言生成3D模型,为设计师和开发者提供了一个便捷的工具,支持快速原型设计和参数调整。
评论总结
关于技术实现的建议
- 评论1指出,CADAM使用ngrok发送图像URL,但建议可以直接使用base64编码的PNG图像,避免使用ngrok。
- 引用:“FYI you can send base64 encoded PNGs, no need to mess about with ngrok.”
- 中文:“你可以发送base64编码的PNG图像,不需要使用ngrok。”
- 评论1指出,CADAM使用ngrok发送图像URL,但建议可以直接使用base64编码的PNG图像,避免使用ngrok。
对文档改进的建议
- 评论2认为项目的README文档需要添加图片以增强可读性。
- 引用:“Readme could really use some pictures.”
- 中文:“README文档真的需要一些图片。”
- 评论2认为项目的README文档需要添加图片以增强可读性。
对项目潜力的评价
- 评论3认为该项目很酷,AI在OpenSCAD中的表现令人惊讶,并提出了对定制训练模型的潜力的好奇。
- 引用:“Cool project. AI is surprisingly good with openscad. I wonder what a custom trained model could do?”
- 中文:“很酷的项目。AI在OpenSCAD中的表现令人惊讶。我想知道定制训练模型能做什么?”
- 评论3认为该项目很酷,AI在OpenSCAD中的表现令人惊讶,并提出了对定制训练模型的潜力的好奇。
对示例和入门指南的需求
- 评论4询问是否有示例或入门指南,以便了解项目的预期效果。
- 引用:“do you have examples or any getting started guide to know what can I expect ?”
- 中文:“你有示例或入门指南吗?我想知道可以期待什么。”
- 评论4询问是否有示例或入门指南,以便了解项目的预期效果。
总结:评论主要围绕技术实现、文档改进、项目潜力以及用户指南展开。建议包括优化图像传输方式、增强文档的可读性,并提供更多示例和入门指南。同时,评论者对AI在OpenSCAD中的表现表示认可,并对定制模型的潜力提出好奇。