姙R，兩大后端構(gòu)建避坑一次講清)
Spirula Studio 安裝指南照片變 3D 高斯?jié)姙R兩大后端構(gòu)建避坑一次講清【免費(fèi)下載鏈接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studioSpirula Studio 是一款跨廠商 GPU 的 3D Gaussian Splatting3DGS訓(xùn)練工具單個自包含二進(jìn)制即可完成視頻/照片 → splat → 帶紋理網(wǎng)格全流程不依賴 Python、PyTorch 和 COLMAP。這篇 Spirula Studio 安裝指南按預(yù)編譯 3 步裝好 / 源碼構(gòu)建一條命令跑通兩條路線覆蓋 Windows、Linux、macOS 三平臺并提前講清最容易翻車的坑讀完能獨(dú)立完成安裝并驗(yàn)證成功。選路徑先決定下載還是自己編你的情況推薦路徑理由本機(jī)出結(jié)果、快速上手預(yù)編譯包解壓即用雙擊開 GUI遠(yuǎn)程/無頭 GPU 服務(wù)器預(yù)編譯包或-DSS_BUILD_GUIOFF構(gòu)建命令行模式瀏覽器看進(jìn)度服務(wù)器無需圖形界面需要定制選項(xiàng)或完全離線源碼構(gòu)建Vulkan 后端一條命令產(chǎn)物自包含結(jié)論很直接能下預(yù)編譯包就別自己編構(gòu)建那章只留給有定制需求的人。 預(yù)編譯包 3 步裝好順手驗(yàn)證打開項(xiàng)目的 Releases 發(fā)布頁選對應(yīng)平臺Windows / Linux / macOS的發(fā)布包下載并解壓雙擊啟動 GUI選數(shù)據(jù)集開訓(xùn)裝完立刻驗(yàn)證兩個命令都正常輸出即成功Windows 下為spirula.exespirula --version # 輸出版本號如 2026.10.16 spirula --help # 輸出 train / sfm / sam / mesh 等子命令說明在遠(yuǎn)程 GPU 服務(wù)器上用spirula train跑訓(xùn)練即可——它默認(rèn)在一個 HTTP 端口7007上提供 3D 預(yù)覽頁面ssh 端口轉(zhuǎn)發(fā)后在本地瀏覽器查看遠(yuǎn)程機(jī)器完全不需要圖形界面。?? Windows 的預(yù)編譯二進(jìn)制動態(tài)鏈接 CRT運(yùn)行機(jī)需要 Visual C Redistributable14.40 及以上。老機(jī)器上的舊版本會讓進(jìn)程在啟動時就崩潰。源碼構(gòu)建第一步選后端后端適用 GPU平臺額外依賴附帶能力Vulkan推薦NVIDIA / AMD / Intel / AppleWindows、Linux、macOSVulkan SDKmacOS 免裝MoltenVK 由 CMake 自動獲取并靜態(tài)鏈接內(nèi)置 SfM、視頻抽幀、AI 分割SAMCUDANVIDIAWindows、LinuxCUDA 工具包無訓(xùn)練與網(wǎng)格化功能相同兩者訓(xùn)練與網(wǎng)格化功能完全一致性能差異通常在幾個百分點(diǎn)以內(nèi)。推薦選 Vulkan跨廠商、構(gòu)建更快、體積更小且 SfM 和 AI 分割只在 Vulkan 構(gòu)建中默認(rèn)開啟。 python3 是可選依賴生成的代碼文件已隨倉庫提交缺 python3 時構(gòu)建腳本自動跳過代碼生成照常編譯。各平臺依賴差異依賴WindowsLinuxmacOS編譯器Visual Studio 2022含 C 工具集gcc/gXcode 命令行工具CMake NinjaVS 自帶腳本自動找到需安裝brew install cmake ninjaVulkan SDK必須必須不需要OpenMP系統(tǒng)自帶系統(tǒng)自帶brew install libomp三平臺構(gòu)建命令各跑通一條先克隆倉庫git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studio WindowsMSVC在cmd或開發(fā)者命令提示符中執(zhí)行.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功產(chǎn)物為build_vulkan\spirula.exe。CUDA 后端換成-DSS_BACKENDcuda產(chǎn)物在build_cuda\spirula.exe。 Linuxbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功產(chǎn)物為build_vulkan/spirula。無頭服務(wù)器加-DSS_BUILD_GUIOFF只構(gòu)建命令行工具不需要顯示器和圖形庫。 macOSApple Siliconbrew install cmake ninja libomp bash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON cmake --build build --target macos_app cmake --build build --target macos_dmgmacOS 只有一個后端構(gòu)建目錄是build/而非build_vulkan/。產(chǎn)物除build/spirula外還會打包出可雙擊的build/Spirula Studio.app和build/Spirula Studio.dmg。MoltenVK 默認(rèn)靜態(tài)鏈接拷到別的 Mac 上也能直接跑。三個平臺構(gòu)建成功后產(chǎn)物都能這樣驗(yàn)證./build_vulkan/spirula --version ./build_vulkan/spirula --help?? 關(guān)于-DSS_ENABLE_PATENTEDON它啟用進(jìn)程內(nèi) GPU 視頻解碼抽幀約快 15 倍且無需安裝 ffmpeg但 H.264/H.265/AV1 解析器存在第三方專利授權(quán)問題是否開啟請自行確認(rèn)所在地區(qū)的合規(guī)要求。不開啟時視頻抽幀會回退調(diào)用系統(tǒng)里的 ffmpeg。最容易翻車的坑一次說清 坑表現(xiàn)怎么辦MSVC 環(huán)境缺失Windows 報vcvars64.bat not found安裝 VS 2022 的C 桌面開發(fā)工作負(fù)載或用開發(fā)者命令提示符腳本會通過 vswhere 自動探測 VS忘裝 Vulkan SDKVulkan 后端 CMake 配置失敗Windows/Linux 先裝 Vulkan SDKmacOS 不需要斷網(wǎng)構(gòu)建 GUIFetchContent 拉取 GLFW/ImGui 失敗GUI 首次構(gòu)建需聯(lián)網(wǎng)下載依賴一次性離線就加-DSS_BUILD_GUIOFF自己亂傳-B構(gòu)建目錄與腳本不一致構(gòu)建步驟沒跑腳本按后端名自動選build_vulkan/或build_cuda/用SS_BACKEND選目錄別手動指定并行編譯 OOM大規(guī)模并行編譯進(jìn)程被系統(tǒng)殺掉腳本已按內(nèi)存自動限并發(fā)約 750MB/任務(wù)無需手動-jmacOS 網(wǎng)格化跑單核OpenMP 沒找到網(wǎng)格化/UV unwrap 串行brew install libomp構(gòu)建腳本會自動探測 keg-only 路徑傳給 CMakeCUDA 版本與編譯器不匹配nvcc 編譯報錯腳本默認(rèn)選最新安裝的 CUDA要指定版本傳-DCMAKE_CUDA_COMPILER...中文路徑/界面顯示方塊CJK 全量字體未下載首次使用中文字體時 GUI 會提示下載并緩存屬正常行為裝完之后能做什么驗(yàn)證命令通過后把照片或視頻丟進(jìn)數(shù)據(jù)集目錄就能開訓(xùn)內(nèi)置 SfM 自動重建相機(jī)位姿無需任何外部工具訓(xùn)練結(jié)果可直接網(wǎng)格化成帶紋理模型。延伸閱讀構(gòu)建系統(tǒng)全貌與全部 CMake 選項(xiàng)docs/build.mdVulkan/CUDA 雙后端架構(gòu)設(shè)計docs/backends.md支持的數(shù)據(jù)集格式與解析規(guī)則docs/datasets.md后端接縫設(shè)計與 Vulkan 后端細(xì)節(jié)src/backend/README.md構(gòu)建入口腳本含并發(fā)限制、依賴日志修復(fù)邏輯build_develop.bash【免費(fèi)下載鏈接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studio創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Spirula Studio 安裝指南：照片變 3D 高斯?jié)姙R，兩大后端構(gòu)建避坑一次講清
Spirula Studio 安裝指南照片變 3D 高斯?jié)姙R兩大后端構(gòu)建避坑一次講清【免費(fèi)下載鏈接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studioSpirula Studio 是一款跨廠商 GPU 的 3D Gaussian Splatting3DGS訓(xùn)練工具單個自包含二進(jìn)制即可完成視頻/照片 → splat → 帶紋理網(wǎng)格全流程不依賴 Python、PyTorch 和 COLMAP。這篇 Spirula Studio 安裝指南按預(yù)編譯 3 步裝好 / 源碼構(gòu)建一條命令跑通兩條路線覆蓋 Windows、Linux、macOS 三平臺并提前講清最容易翻車的坑讀完能獨(dú)立完成安裝并驗(yàn)證成功。選路徑先決定下載還是自己編你的情況推薦路徑理由本機(jī)出結(jié)果、快速上手預(yù)編譯包解壓即用雙擊開 GUI遠(yuǎn)程/無頭 GPU 服務(wù)器預(yù)編譯包或-DSS_BUILD_GUIOFF構(gòu)建命令行模式瀏覽器看進(jìn)度服務(wù)器無需圖形界面需要定制選項(xiàng)或完全離線源碼構(gòu)建Vulkan 后端一條命令產(chǎn)物自包含結(jié)論很直接能下預(yù)編譯包就別自己編構(gòu)建那章只留給有定制需求的人。 預(yù)編譯包 3 步裝好順手驗(yàn)證打開項(xiàng)目的 Releases 發(fā)布頁選對應(yīng)平臺Windows / Linux / macOS的發(fā)布包下載并解壓雙擊啟動 GUI選數(shù)據(jù)集開訓(xùn)裝完立刻驗(yàn)證兩個命令都正常輸出即成功Windows 下為spirula.exespirula --version # 輸出版本號如 2026.10.16 spirula --help # 輸出 train / sfm / sam / mesh 等子命令說明在遠(yuǎn)程 GPU 服務(wù)器上用spirula train跑訓(xùn)練即可——它默認(rèn)在一個 HTTP 端口7007上提供 3D 預(yù)覽頁面ssh 端口轉(zhuǎn)發(fā)后在本地瀏覽器查看遠(yuǎn)程機(jī)器完全不需要圖形界面。?? Windows 的預(yù)編譯二進(jìn)制動態(tài)鏈接 CRT運(yùn)行機(jī)需要 Visual C Redistributable14.40 及以上。老機(jī)器上的舊版本會讓進(jìn)程在啟動時就崩潰。源碼構(gòu)建第一步選后端后端適用 GPU平臺額外依賴附帶能力Vulkan推薦NVIDIA / AMD / Intel / AppleWindows、Linux、macOSVulkan SDKmacOS 免裝MoltenVK 由 CMake 自動獲取并靜態(tài)鏈接內(nèi)置 SfM、視頻抽幀、AI 分割SAMCUDANVIDIAWindows、LinuxCUDA 工具包無訓(xùn)練與網(wǎng)格化功能相同兩者訓(xùn)練與網(wǎng)格化功能完全一致性能差異通常在幾個百分點(diǎn)以內(nèi)。推薦選 Vulkan跨廠商、構(gòu)建更快、體積更小且 SfM 和 AI 分割只在 Vulkan 構(gòu)建中默認(rèn)開啟。 python3 是可選依賴生成的代碼文件已隨倉庫提交缺 python3 時構(gòu)建腳本自動跳過代碼生成照常編譯。各平臺依賴差異依賴WindowsLinuxmacOS編譯器Visual Studio 2022含 C 工具集gcc/gXcode 命令行工具CMake NinjaVS 自帶腳本自動找到需安裝brew install cmake ninjaVulkan SDK必須必須不需要OpenMP系統(tǒng)自帶系統(tǒng)自帶brew install libomp三平臺構(gòu)建命令各跑通一條先克隆倉庫git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studio WindowsMSVC在cmd或開發(fā)者命令提示符中執(zhí)行.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功產(chǎn)物為build_vulkan\spirula.exe。CUDA 后端換成-DSS_BACKENDcuda產(chǎn)物在build_cuda\spirula.exe。 Linuxbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功產(chǎn)物為build_vulkan/spirula。無頭服務(wù)器加-DSS_BUILD_GUIOFF只構(gòu)建命令行工具不需要顯示器和圖形庫。 macOSApple Siliconbrew install cmake ninja libomp bash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON cmake --build build --target macos_app cmake --build build --target macos_dmgmacOS 只有一個后端構(gòu)建目錄是build/而非build_vulkan/。產(chǎn)物除build/spirula外還會打包出可雙擊的build/Spirula Studio.app和build/Spirula Studio.dmg。MoltenVK 默認(rèn)靜態(tài)鏈接拷到別的 Mac 上也能直接跑。三個平臺構(gòu)建成功后產(chǎn)物都能這樣驗(yàn)證./build_vulkan/spirula --version ./build_vulkan/spirula --help?? 關(guān)于-DSS_ENABLE_PATENTEDON它啟用進(jìn)程內(nèi) GPU 視頻解碼抽幀約快 15 倍且無需安裝 ffmpeg但 H.264/H.265/AV1 解析器存在第三方專利授權(quán)問題是否開啟請自行確認(rèn)所在地區(qū)的合規(guī)要求。不開啟時視頻抽幀會回退調(diào)用系統(tǒng)里的 ffmpeg。最容易翻車的坑一次說清 坑表現(xiàn)怎么辦MSVC 環(huán)境缺失Windows 報vcvars64.bat not found安裝 VS 2022 的C 桌面開發(fā)工作負(fù)載或用開發(fā)者命令提示符腳本會通過 vswhere 自動探測 VS忘裝 Vulkan SDKVulkan 后端 CMake 配置失敗Windows/Linux 先裝 Vulkan SDKmacOS 不需要斷網(wǎng)構(gòu)建 GUIFetchContent 拉取 GLFW/ImGui 失敗GUI 首次構(gòu)建需聯(lián)網(wǎng)下載依賴一次性離線就加-DSS_BUILD_GUIOFF自己亂傳-B構(gòu)建目錄與腳本不一致構(gòu)建步驟沒跑腳本按后端名自動選build_vulkan/或build_cuda/用SS_BACKEND選目錄別手動指定并行編譯 OOM大規(guī)模并行編譯進(jìn)程被系統(tǒng)殺掉腳本已按內(nèi)存自動限并發(fā)約 750MB/任務(wù)無需手動-jmacOS 網(wǎng)格化跑單核OpenMP 沒找到網(wǎng)格化/UV unwrap 串行brew install libomp構(gòu)建腳本會自動探測 keg-only 路徑傳給 CMakeCUDA 版本與編譯器不匹配nvcc 編譯報錯腳本默認(rèn)選最新安裝的 CUDA要指定版本傳-DCMAKE_CUDA_COMPILER...中文路徑/界面顯示方塊CJK 全量字體未下載首次使用中文字體時 GUI 會提示下載并緩存屬正常行為裝完之后能做什么驗(yàn)證命令通過后把照片或視頻丟進(jìn)數(shù)據(jù)集目錄就能開訓(xùn)內(nèi)置 SfM 自動重建相機(jī)位姿無需任何外部工具訓(xùn)練結(jié)果可直接網(wǎng)格化成帶紋理模型。延伸閱讀構(gòu)建系統(tǒng)全貌與全部 CMake 選項(xiàng)docs/build.mdVulkan/CUDA 雙后端架構(gòu)設(shè)計docs/backends.md支持的數(shù)據(jù)集格式與解析規(guī)則docs/datasets.md后端接縫設(shè)計與 Vulkan 后端細(xì)節(jié)src/backend/README.md構(gòu)建入口腳本含并發(fā)限制、依賴日志修復(fù)邏輯build_develop.bash【免費(fèi)下載鏈接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studio創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考