이미지로부터 3D를 재구성하는 GUI 및 명령줄 인터페이스를 갖춘 범용 Structure-from-Motion 및 Multi-View Stereo 파이프라인입니다.
harry7557558/spirula-studio
사진이나 동영상으로 스플랫과 텍스처 메시를 생성하는 크로스 벤더 3D Gaussian Splatting 트레이너로, Python 없이 Vulkan 또는 CUDA에서 실행됩니다.
- 스타
- 2,163
- 포크
- 210
- 열린 이슈
- 70
- 마지막 커밋
- 어제
어떤 프로젝트인가요?
Spirula Studio는 원본 사진이나 동영상으로 3D Gaussian Splatting 모델을 학습하며, SfM부터 학습과 메시 생성까지 하나의 독립 실행형 바이너리에서 처리합니다. Python, PyTorch 또는 별도의 COLMAP 설치가 필요하지 않습니다.
Vulkan을 사용하는 기본 백엔드는 Windows, Linux, macOS에서 NVIDIA, AMD, Intel, Apple GPU로 실행됩니다. NVIDIA GPU용 CUDA 백엔드도 제공됩니다. 이 프로젝트는 8 GB VRAM에서 최대 1천만 개의 SH3 Gaussian을 처리하는 양자화 학습을 지원하며, 왜곡 보정 없이 등거리 원통 도법 데이터셋을 포함한 어안 및 360° 카메라도 지원합니다.
내장 파이프라인에는 SfM, 동영상 프레임 추출, SAM 체크포인트를 이용한 AI 마스킹, 깊이 및 노멀 출력이 포함됩니다. 또한 원격 GPU 학습을 위해 SSH 터널로 접속할 수 있는 웹 뷰어도 제공합니다.
핵심 기능
- 01Vulkan 컴퓨트를 통해 NVIDIA, AMD, Intel, Apple GPU에서 실행됩니다.
- 02양자화 학습을 사용해 8 GB VRAM으로 최대 1천만 개의 SH3 Gaussian을 학습합니다.
- 03360° 및 등거리 원통 도법 카메라 데이터셋을 바로 지원합니다.
- 04SfM, 동영상 프레임 추출, AI 마스킹 기능이 내장되어 있습니다.
- 05깊이, 노멀, 텍스처 메시를 내보냅니다.
- 06GUI와 CLI를 제공하며, 원격 학습을 위한 브라우저 기반 뷰어도 포함합니다.
활용 사례
- Python이나 COLMAP을 설치하지 않고 휴대폰이나 일반 카메라로 촬영한 동영상에서 3D 장면을 재구성할 때.
- CUDA를 사용할 수 없는 AMD, Intel 또는 Apple Silicon 시스템에서 스플랫을 학습할 때.
- 별도의 왜곡 보정 과정 없이 360° 또는 어안 영상을 처리할 때.
- 원격 GPU 서버에서 학습을 실행하고 SSH로 진행 상황을 확인할 때.
빠른 시작
- 1
Releases 페이지에서 사용 중인 플랫폼에 맞는 바이너리를 다운로드하세요
- 2
저장소를 클론하고 해당 폴더로 이동하세요(Linux, Vulkan backend로 소스에서 빌드)
cd spirula-studio/ - 3
Vulkan backend로 Linux 빌드 스크립트를 실행하세요
bash build_develop.bash -DSS_BACKEND=vulkan -DSS_ENABLE_PATENTED=ON
사용 전 알아둘 점
- GPL-3.0 라이선스로 제공됩니다. 카피레프트 라이선스이므로 파생 저작물도 동일한 조건으로 배포해야 합니다.
- 소스에서 빌드하려면 먼저 Vulkan SDK를 설치해야 합니다.
- 프로젝트를 거의 한 사람이 관리하므로 이슈와 PR에 대한 응답이 늦을 수 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- spirula-studio은(는) 무엇인가요?
- 사진이나 동영상으로 스플랫과 텍스처 메시를 생성하는 크로스 벤더 3D Gaussian Splatting 트레이너로, Python 없이 Vulkan 또는 CUDA에서 실행됩니다. Spirula Studio는 원본 사진이나 동영상으로 3D Gaussian Splatting 모델을 학습하며, SfM부터 학습과 메시 생성까지 하나의 독립 실행형 바이너리에서 처리합니다. Python, PyTorch 또는 별도의 COLMAP 설치가 필요하지 않습니다.
- spirula-studio은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- spirula-studio은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- spirula-studio은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. spirula-studio의 마지막 커밋은 2026년 11월 5일입니다.
- spirula-studio은(는) 어디에 사용할 수 있나요?
- Python이나 COLMAP을 설치하지 않고 휴대폰이나 일반 카메라로 촬영한 동영상에서 3D 장면을 재구성할 때. CUDA를 사용할 수 없는 AMD, Intel 또는 Apple Silicon 시스템에서 스플랫을 학습할 때. 별도의 왜곡 보정 과정 없이 360° 또는 어안 영상을 처리할 때. 원격 GPU 서버에서 학습을 실행하고 SSH로 진행 상황을 확인할 때.
- spirula-studio는 어떻게 설치하나요?
- Releases 페이지에서 사용 중인 플랫폼에 맞는 바이너리를 다운로드하세요 저장소를 클론하고 해당 폴더로 이동하세요(Linux, Vulkan backend로 소스에서 빌드): cd spirula-studio/ Vulkan backend로 Linux 빌드 스크립트를 실행하세요: bash build_develop.bash -DSS_BACKEND=vulkan -DSS_ENABLE_PATENTED=ON
- spirula-studio은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/harry7557558/spirula-studio
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
사진을 3D 모델로 변환하고 카메라 트래킹과 HDR 이미지를 생성하는 오픈 소스 노드 기반 포토그래메트리 시각 프로그래밍 도구입니다.
WebGL2와 WebGPU를 기반으로 모든 브라우저에서 실행되는 인터랙티브 3D 앱, 게임, 시각화를 만들 수 있는 오픈소스 JavaScript 게임 엔진입니다.
대형 모델용 스트리밍 LOD를 지원하고 WebGPU와 WebGL2에서 동작하는 Three.js 3D Gaussian Splatting 렌더러입니다.
파일을 열지 않고 Windows Explorer에서 3D Gaussian Splatting PLY 파일과 Spatialograph Maker 프로젝트의 미리 보기를 제공하는 썸네일 핸들러입니다.
물체 이미지 한 장으로 보이지 않는 면까지 생성해 3D Gaussian splat 모델을 만드는 추론 SDK이자 데모입니다.