earthtojake/step-parts

step-parts은(는) 무엇을 하나요?

step.parts에서 구매 가능한 일반 CAD 부품(액추에이터, 서보, 모터, 전자 기판, 커넥터, 나사, 볼트, 너트, 와셔, 베어링, 스탠드오프 등)을 검색, 평가, 다운로드합니다. Codex가 단순화된 플레이스홀더 지오메트리를 생성하기 전에 호스팅된 step.parts 카탈로그를 검색하거나, 모호한 부품 이름, 표준, 별칭, 치수를 해결하고, 일치하는 부품을 선택하고, 표준 .step 파일을 가져오며, 체크섬을 확인하거나, step.parts API/OpenAPI/카탈로그 엔드포인트를 사용해야 할 때 사용합니다.

사용 방법

1. 카탈로그 검색: 공구, 모터, 커넥터 등 찾고자 하는 부품 유형을 설명하는 자연어 쿼리를 사용합니다.
2. 결과 평가: 반환된 부품 이름, 표준, 치수, 체크섬을 검토하여 원하는 사양과 일치하는지 확인합니다.
3. 부품 다운로드: 일치하는 부품을 선택하면 표준 .step 형식의 3D 모델 파일이 다운로드됩니다.
4. 통합 프로젝트: 다운로드한 .step 파일을 CAD 프로젝트에 직접 가져오거나, AI 에이전트가 추가 처리를 위해 참조할 수 있습니다.

지원 플랫폼

• AI 에이전트: Codex, Claude Code, Cursor 등
• 인프라: AWS, GCP, Azure, 로컬 환경
• CI/CD: GitHub Actions, GitLab CI, Jenkins

기술 세부 사항

• API: step.parts OpenAPI 사양 및 카탈로그 엔드포인트 사용
• 데이터 형식: JSON 응답, .step 3D 모델 파일
• 보안: 다운로드된 파일의 체크섬(SHA256) 자동 검증
• 오프라인 지원: 사전 캐시된 카탈로그 데이터로 오프라인에서도 검색 가능

예시 명령어

# CLI를 통한 검색 예시
parts-cli search "M3 x 12mm socket head cap screw"

# Python API 사용 예시
from step_parts import Catalog

catalog = Catalog()
parts = catalog.search("servo motor", limit=5)
for part in parts:
    print(f"{part.name}: {part.standard}, {part.dimensions}")

관련 리소스

• step.parts 공식 문서
• OpenAPI 명세
• 카탈로그 API