ghbalf/freecad-ai

FreeCAD AI – FreeCAD 내 AI 지원 3D 모델링

무엇인가 – 채팅 스타일 어시스턴트를 추가하는 FreeCAD 워크벤치입니다. 자연어 명령(예: “50 mm × 30 mm × 20 mm 상자를 만들어 줘”)을 입력하면 어시스턴트가 Python 코드를 생성하거나, FreeCAD에서 요청된 작업을 수행하는 미리 정의된 “도구” 집합을 호출합니다. 결과는 활성 FreeCAD 문서에 직접 삽입됩니다.

주요 기능

• 채팅 UI가 FreeCAD 내부에 도킹되며, 지원되는 22개 LLM 제공자(OpenAI, Anthropic, Ollama, Gemini 등)로부터 응답을 스트리밍합니다.
• Plan vs Act: Plan은 생성된 코드를 보여 주어 검토할 수 있게 합니다. Act는 코드를 자동 실행하거나, 더 바람직하게는 안전한 undo 트랜잭션으로 감싼 구조화된 도구 호출을 실행할 수 있습니다.
• 도구 라이브러리: 50개의 내장 FreeCAD 작업(기본 도형, 스케치, 패드, 포켓, 불리언 연산, 필렛, 패턴, 내보내기 등 생성)과 사용자가 자신의 Python 함수를 추가할 수 있는 훅 시스템.
• 비전 지원 – 채팅에 첨부된 이미지는 비전 지원 모델로 전송됩니다. 그렇지 않으면 폴백 MCP 서버에서 처리됩니다.
• 세션 관리 – 채팅 세션 저장/불러오기, 자동 컨텍스트 요약, 제공자를 사용할 수 없을 때의 폴백 프로필.
• 외부 의존성 없음 – 이 워크벤치는 Python 표준 라이브러리만 사용합니다.

설치 방법

1. FreeCAD 1.0+를 설치합니다.
2. repo를 클론하고 FreeCAD의 Mod 디렉터리에 심볼릭 링크를 만들거나 복사합니다(경로는 OS마다 다르며 README 참조).
3. FreeCAD를 재시작하면 FreeCAD AI 워크벤치가 선택기에 나타납니다.
4. 워크벤치를 열고 Edit → Preferences → FreeCAD AI 또는 톱니바퀴 아이콘 설정 대화상자에서 LLM 제공자(API 키 또는 로컬 Ollama)를 구성한 뒤 채팅을 시작합니다.

일반적인 워크플로

1. 설명을 입력합니다.
2. Plan 모드에서 생성된 Python을 검사하고 Execute를 누릅니다(실패하면 Fix with AI).
3. Act 모드에서는 모델이 도구를 직접 호출하게 하여 더 안전하게 모델링하거나, 원시 코드 실행으로 폴백합니다.
4. 내장 도구(export_model, capture_viewport 등)를 사용하거나 .py 또는 .FCMacro 파일로 사용자 정의 도구를 추가합니다.

대상 사용자 – FreeCAD를 떠나지 않고 자연어 기반 모델링을 실험하고 싶은 CAD 디자이너, 취미 사용자 또는 개발자. 아직 alpha 단계이므로 충돌과 호환성 깨지는 변경이 발생할 수 있으니 자주 백업하세요.