AutoDesign-LLM

⚡ 빠른 시작 (맥북프로)

cd ~/Desktop/Cursor/autodesign-llm
./scripts/setup.sh # 1회: 환경 + 테스트
./scripts/run.sh --optimize --report # 데모(오프라인)
./scripts/run.sh --backend hermes --trace "엔진 브래킷, 5kN, AlSi10Mg, 안전계수 2.0, 피로"

폴더 구성

autodesign-llm/
├── README.md ← 본 파일
├── AutoDesign-LLM_요약.pptx ★ 전체 요약 발표자료 (16장, 구성도 포함)
├── DESIGN.md 시스템 설계 (구조 부품 + 외형 툴체인)
├── docs/ 개발 문서 (Markdown)
│ ├── 00-INDEX.md 문서 인덱스 + 세 버전 관계
│ ├── 01-ROADMAP.md [기획자] 전체 개발 로드맵
│ ├── 02-DEV-PROCESS.md [개발자] 개발 프로세스
│ ├── 03-VARIANT-LOCAL.md 배포 v1: 로컬 LLM
│ ├── 04-VARIANT-HYBRID.md 배포 v2: 로컬+RAG 하이브리드 (주력)
│ └── 05-VARIANT-CLOUD.md 배포 v3: 클라우드
├── PROGRESS.md ★ 구현 진행 현황 (Phase 0 완료, 다음 단계)
├── src/autodesign/ ★ 코어 구현 코드 (Phase 0~7)
│ ├── spec.py 1 설계명세(DesignSpec)
│ ├── llm/ 2 LLM 추상화 + Mock 백엔드
│ ├── geometry/ 3 파라메트릭 브래킷 (FreeCAD 지연연결)
│ ├── validation/ 4 검증: 기하·구조(솔버)·DFM·피로·모달
│ ├── orchestrator/ 5 생성→검증→자기교정 루프
│ ├── knowledge/ RAG 지식베이스 + 사전검토 (Phase 3)
│ ├── optimization/ 경량화 최적화 (Phase 5)
│ ├── exterior/ 외형 개념→공력 루프 (Phase 6)
│ ├── reporting/ 검토보고서 HTML/PDF (Phase 4)
│ ├── api.py 통합 API 파사드 (Phase 7)
│ └── cli.py 데모 실행
├── tests/ 테스트 (26 passed)
├── samples/ 샘플 검토보고서(HTML/PDF)
├── pyproject.toml
├── word/ ★ 위 문서의 Word(.docx) 버전 (구성도 이미지 포함)
├── assets/ 시스템 구성도 이미지(PNG) + 생성 스크립트
│ ├── diagram_system_overview.png
│ ├── diagram_variants.png
│ ├── diagram_v1_local.png / v2_hybrid / v3_cloud.png
│ ├── make_diagrams.py 다이어그램 생성 스크립트
│ └── md_to_docx.py Markdown→Word 변환 스크립트

읽는 순서 (권장)

코어 실행 (Phase 0~7 — 의존성 없이 동작)

pip3 install --user pytest
# 구조 부품: 자연어 → 명세 → 사전검토(RAG) → 생성·검증·자기교정 → 경량화 → 보고서
PYTHONPATH=src python3 -m autodesign.cli --optimize --report
# 외형(공력): 개념 생성 → 공력 검증 → 교정 루프
PYTHONPATH=src python3 -m autodesign.cli --exterior
# 테스트
PYTHONPATH=src python3 -m pytest tests/ -q # 26 passed

문서 재생성 방법

pip3 install --user python-docx matplotlib
python3 assets/make_diagrams.py # 구성도 PNG 재생성
python3 assets/md_to_docx.py # Word 문서 재생성
python3 assets/build_pptx.py # 요약 PPTX 재생성