Bygga — 3D로 생성된 IKEA 조립 가이드

개요: usebygga.com의 웹 앱으로, IKEA 상자에 있는 이름이나 품번(예: BISSA 또는 MALM)을 입력하면 3D 선화로 렌더링된 전체 조립 가이드를 얻을 수 있습니다. 종이 매뉴얼과 유사하지만 어떤 각도에서도 볼 수 있고 각 단계가 음성으로 읽어줍니다.

작동 방식

Bygga는 IKEA의 PDF 매뉴얼을 사용하지 않습니다. 대신 IKEA의 공개 제품 목록에서 데이터를 가져와 파라메트릭 플랜 생성기로 모든 가이드를 자체 생성합니다. 현재 1,171개의 IKEA 제품(영국 및 미국 시리즈에서 2,180개 크기)을 다루며, 모두 three.js 라인아트 엔진으로 오프라인에서 그려집니다.

음성 제어

이 앱은 핸즈프리입니다. 1,476개의 사전 녹음된 오디오 클립(Kokoro라는 음성 사용)이 포함되어 있어 API 키 없이 재생됩니다. 또한 Together AI에서 실행되는 Whisper(음성 인식 시스템)를 사용하여 "next"라는 단어를 듣고, 오디오가 재생되는 동안에도 들을 수 있도록 에코 제거 기능이 있습니다.

AI 지원

카탈로그에 없는 제품이거나 사진 조회 및 도움이 필요한 경우, 방문자는 자신의 Together AI API 키를 입력할 수 있습니다. AI는 다음을 수행할 수 있습니다:

• 카탈로그에 없는 제품의 조립 가이드 초안 작성
• 사진에서 제품 조회
• 정확한 패널, 피팅, 단계 그림으로 질문에 답변

기타 기능

• 공유 카드: 동일한 3D 엔진으로 그려짐
• A4 인쇄 보기: 종이 가이드용
• 오프라인 지원: 서비스 워커를 통해 열린 가이드가 신호 없이도 작동
• 빌드 페이지: 완성된 모든 빌드를 실제 크기로 나란히 표시

로컬 실행

리포지토리를 클론하고 npm install, npm run dev를 실행한 후 localhost:3000을 열고 BISSA를 입력해 보세요. URL(예: /build/malm-3-drawers?step=12)로 특정 단계로 이동하거나 /build/malm-3-drawers/print에서 인쇄하고 /builds에서 완성된 빌드를 볼 수 있습니다. AI 기능을 사용하려면 .env.example을 .env.local로 복사하고 TOGETHER_API_KEY를 설정한 후 앱의 키 상자에 모의 키를 붙여넣으세요(모의 키를 허용하는 것은 npm run dev뿐입니다).

테스트

두 가지 테스트 스위트가 포함되어 있습니다: npm run voice:check는 283개의 녹음된 청취 실행을 재생하고, npm run ikea:check는 모든 카탈로그 행을 테스트합니다.

로드맵

계획된 개선 사항:

• 생성기가 특이한 모양(삼각 선반, 코너 조합, 특정 PAX 너비)을 처리하도록 개선
• 음성 언어 추가
• 실제 매뉴얼에서 수동 스캐너 기능 테스트

라이선스 및 상표

MIT 라이선스이지만 IKEA와 제휴하지 않습니다. IKEA 및 해당 제품 이름은 Inter IKEA Systems B.V.의 상표이며, 라이선스는 이에 대한 권리를 부여하지 않습니다.