Repolode
제출하기
img2threejs

img2threejs/img2interior

사진 한 장으로 편집 가능한 Blender 씬, Three.js 뷰어, 이동 가능한 GLB 모델을 만드는 에이전트 기반 스킬입니다.

GitHub에서 보기
스타
46
포크
6
열린 이슈
0
마지막 커밋
13시간 전

어떤 프로젝트인가요?

img2 Interior는 img2 harness를 기반으로 하며 Claude Code, Codex, OpenCode에서 사용하는 에이전트 구동형 스킬입니다. 실내 사진 한 장을 입력하면 에이전트가 이미지를 분석하고, 메시와 물리 기반 머티리얼이 포함된 Blender 씬을 만든 뒤 렌더링 결과를 레퍼런스와 비교하고 Three.js 뷰어를 빌드합니다.

워크플로는 세 가지 결과물을 생성합니다. 편집 가능한 Blender 마스터 파일, 라이트맵과 프로브 사이드카 파일 및 뷰어 코드가 포함된 런타임 GLB, 외관을 베이크한 별도의 정적·이동형 GLB입니다. 사진 한 장만으로는 확인할 수 있는 정보가 제한적이므로 치수, 가려진 표면, 카메라 값은 추정치로 표시합니다. 이 프로젝트는 정확한 복원이나 포토리얼리즘을 보장하지 않으며, 사전 학습된 이미지-메시 모델도 아닙니다.

설치할 때는 npm으로 전용 prefix에 패키지를 가져온 다음 img2 harness에 등록합니다. 네이티브 제작 기능을 사용하려면 bpy와 numpy가 설치된 별도의 Python 3.11 환경이 필요합니다. 소스는 상용화가 제한된 소스 공개 라이선스로 제공됩니다.

핵심 기능

  • 01실내 레퍼런스 이미지 한 장으로 편집 가능한 Blender 씬을 만듭니다.
  • 02결과를 렌더링해 레퍼런스와 비교한 뒤 메시와 머티리얼을 수정합니다.
  • 03.blend 마스터 파일, Three.js 뷰어가 포함된 런타임 GLB, 이동 가능한 GLB를 내보냅니다.
  • 04프로젝트에 리소스 출처, 가정, 검증 근거를 기록합니다.
  • 05npm으로 설치하고 img2 harness에 등록해 Claude Code, Codex, OpenCode에서 사용할 수 있습니다.

활용 사례

  • 인테리어 디자인 콘셉트 이미지를 고객 검토용으로 둘러볼 수 있는 3D 공간으로 변환하기.
  • 레퍼런스 사진 한 장으로 인테리어 씬의 편집 가능한 Blender 시작 파일 만들기.
  • Three.js 뷰어로 브라우저에서 방을 둘러보는 환경 제공하기.
  • 다른 glTF 호환 도구에서 사용할 독립형 GLB 방 모델 만들기.

빠른 시작

  1. 1

    전용 prefix에 npm으로 패키지를 설치합니다

    npm install --prefix "$HOME/.local/share/img2interior" @img2threejs/img2interior@0.3.1
  2. 2

    설치한 사본을 img2 harness에 등록합니다

    npx --yes @img2threejs/img2@0.4.0 add --link "$HOME/.local/share/img2interior/node_modules/@img2threejs/img2interior" --yes
  3. 3

    에이전트 세션을 다시 시작하고 프로젝트를 연 다음, 방 이미지 한 장으로 복사해서 사용하는 프롬프트를 실행합니다

사용 전 알아둘 점

  • 사전 학습된 모델이나 원클릭 모델이 아닙니다. 결과는 장면별 제작 방식과 시각적 검토에 따라 달라집니다.
  • Claude Code, Codex 또는 OpenCode와 함께 bpy 4.3.0이 설치된 별도의 Python 3.11 환경이 필요합니다.
  • img2 harness(0.4.0 이상)와 WebGL을 지원하는 브라우저가 필요합니다.
  • 라이선스는 NOASSERTION으로 표시되어 있습니다. 도구 자체를 상용화하려면 사전 서면 허가가 필요합니다.

토픽

#three-js#blender#3d-reconstruction#interior-design#glb#claude-code#agent-skill#webgl

자주 묻는 질문

img2interior은(는) 무엇인가요?
사진 한 장으로 편집 가능한 Blender 씬, Three.js 뷰어, 이동 가능한 GLB 모델을 만드는 에이전트 기반 스킬입니다. img2 Interior는 img2 harness를 기반으로 하며 Claude Code, Codex, OpenCode에서 사용하는 에이전트 구동형 스킬입니다. 실내 사진 한 장을 입력하면 에이전트가 이미지를 분석하고, 메시와 물리 기반 머티리얼이 포함된 Blender 씬을 만든 뒤 렌더링 결과를 레퍼런스와 비교하고 Three.js 뷰어를 빌드합니다.
img2interior은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
img2interior은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
img2interior은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. img2interior의 마지막 커밋은 2026년 10월 19일입니다.
img2interior은(는) 어디에 사용할 수 있나요?
인테리어 디자인 콘셉트 이미지를 고객 검토용으로 둘러볼 수 있는 3D 공간으로 변환하기. 레퍼런스 사진 한 장으로 인테리어 씬의 편집 가능한 Blender 시작 파일 만들기. Three.js 뷰어로 브라우저에서 방을 둘러보는 환경 제공하기. 다른 glTF 호환 도구에서 사용할 독립형 GLB 방 모델 만들기.
img2interior는 어떻게 설치하나요?
전용 prefix에 npm으로 패키지를 설치합니다: npm install --prefix "$HOME/.local/share/img2interior" @img2threejs/img2interior@0.3.1 설치한 사본을 img2 harness에 등록합니다: npx --yes @img2threejs/img2@0.4.0 add --link "$HOME/.local/share/img2interior/node_modules/@img2threejs/img2interior" --yes 에이전트 세션을 다시 시작하고 프로젝트를 연 다음, 방 이미지 한 장으로 복사해서 사용하는 프롬프트를 실행합니다
img2interior은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/img2threejs/img2interior

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트