ghbalf/freecad-ai

해결하는 문제

FreeCAD AI는 FreeCAD에서 3D 모델링을 위한 자연어 인터페이스를 제공합니다. 사용자는 복잡한 CAD 소프트웨어 메뉴를 수동으로 탐색하거나 Python 스크립트를 직접 작성하는 대신, 평범한 영어로 요구사항을 설명함으로써 3D 모델을 생성, 수정, 분석할 수 있습니다.

작동 방식

이 프로젝트는 FreeCAD 내부에 채팅 인터페이스를 직접 통합한 워크벤치로 작동합니다. OpenAI, Anthropic 또는 로컬 Ollama 인스턴스와 같은 다양한 LLM 제공업체에 연결하여 사용자 프롬프트를 실행 가능한 Python 코드로 변환합니다. 시스템은 두 가지 주요 모드로 작동합니다: "계획" 모드에서는 코드 실행 전 사용자가 코드를 검토하고 승인할 수 있으며, "실행" 모드에서는 50개 이상의 구조화된 도구(예: create_primitive, boolean_operation, fillet_edges) 라이브러리를 사용해 더 높은 신뢰성으로 자동 작업을 수행할 수 있습니다.

대상 사용자

디자인 프로세스를 가속화하고 싶거나, 반복적인 모델링 작업을 자동화하고 싶은 FreeCAD 사용자, 또는 AI 지원을 통해 3D 파라메트릭 모델링의 진입 장벽을 낮추고 싶은 사용자에게 적합합니다.

주요 특징

• 다중 제공업체 지원: 로컬 및 클라우드 기반 옵션을 포함해 21개의 LLM 제공업체와 호환됩니다.
• 도구 호출: 구조화된 작업을 사용해 원시 코드 생성보다 더 안전하고 신뢰성 높은 3D 모델링을 보장합니다.
• 시각 통합: 뷰포트 스크린샷 및 이미지 첨부를 지원하여 AI가 모델의 시각적 맥락을 제공받을 수 있습니다.
• MCP 서버: Model Context Protocol (MCP) 서버로 노출 가능하여 외부 AI 클라이언트(예: Claude Desktop)가 FreeCAD를 제어할 수 있습니다.
• 자기 수정: 실패한 코드를 자동으로 감지하고 LLM에 다시 시도(최대 3회)를 전송합니다.
• 외부 종속성 없음: Python 표준 라이브러리만 사용하여 구현되어 외부 패키지가 필요 없습니다.