練)
Spirula Studio 安裝教程三步在 Windows、Linux 與 macOS 上跑通 3DGS 訓(xùn)練【免費(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先說好我不打算一上來講架構(gòu)咱們先把軟件跑起來跑的時候順便把每步為什么這么做講清楚。Spirula Studio 是一個開源的 3D 高斯?jié)姙R3D Gaussian Splatting訓(xùn)練工具Python、PyTorch、COLMAP 這些統(tǒng)統(tǒng)不用裝輸入素材 → splat 模型 → 帶紋理網(wǎng)格整條鏈路被塞進(jìn)一個自包含的二進(jìn)制里。因此 Spirula Studio 安裝這件事相當(dāng)輕整篇教程其實(shí)只回答兩個問題你要現(xiàn)成包還是自己編你的顯卡是 NVIDIA 還是別的先拿現(xiàn)成包三步啟動最省事的路線三步進(jìn) Releases 發(fā)布頁按你的系統(tǒng)Windows / Linux / macOS取對應(yīng)安裝包解壓雙擊啟動 GUI選數(shù)據(jù)集開訓(xùn)。完事。如果你在用一臺不帶顯示器的機(jī)器比如遠(yuǎn)程服務(wù)器同一套二進(jìn)制也帶命令行模式怎么部署看下面無頭與遠(yuǎn)程那一節(jié)。源碼路線一Vulkan 還是 CUDA先選計(jì)算后端現(xiàn)成包對不上你的環(huán)境或者想開關(guān)某些功能時走源碼構(gòu)建。動手前先回答后端問題。**Vulkan推薦**是跨廠商路線NVIDIA 與 AMD也包括 Intel 和 Apple 的顯卡都能跑且是 macOS 上唯一的選擇。它的構(gòu)建更快、二進(jìn)制更小SfM 重建、視頻抽幀和 AI 分割也一并打包在內(nèi)不必另配外部工具。Windows 和 Linux 上要先裝 Vulkan SDKmacOS 可以跳過這一步——CMake 會自動獲取 MoltenVK 并做靜態(tài)鏈接編出的二進(jìn)制拷到任何一臺 Mac 都能直接跑。CUDA則是 NVIDIA 專屬的傳統(tǒng)路線需要裝 CUDA 工具包Windows 與 Linux 支持macOS 不支持。兩者在訓(xùn)練與網(wǎng)格化上的功能完全一致速度差距通常只有幾個百分點(diǎn)按機(jī)器里插的什么卡選就行。后端定了之后三個平臺的依賴大同小異列給你編譯器Windows 用 Visual Studio 2022含 C 工具集或 GCC/ClangLinux 用 gcc/gmacOS 用 Xcode 命令行工具CMake NinjaVS 里一般自帶腳本會自己找Linux 與 macOS 需要自行安裝Vulkan SDKVulkan 后端在 Windows 與 Linux 上必備macOS 不需要CUDA 工具包僅 CUDA 后端要macOS 不支持python3可選。缺失時代碼生成步驟會被跳過生成文件已隨倉庫提交沒有 python3 照樣能構(gòu)建。源碼路線二三個平臺的構(gòu)建命令克隆一次代碼即可git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studioWindowsMSVC在cmd或開發(fā)者命令提示符里執(zhí)行.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功的產(chǎn)物是build_vulkan\spirula.exe。想走 CUDA 后端把命令里的-DSS_BACKENDvulkan換成-DSS_BACKENDcuda最終產(chǎn)物變?yōu)閎uild_cuda\spirula.exe。兩個細(xì)節(jié)腳本會自己通過 vswhere 找到 VS 并調(diào)用 vcvars64CMake/Ninja 不在 PATH 時則回退到 VS 自帶的版本。另外別自己帶-B——構(gòu)建目錄由腳本按后端名取改了對不上。Linuxbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功產(chǎn)物為build_vulkan/spirula。無顯示器的服務(wù)器加-DSS_BUILD_GUIOFF只出命令行工具——產(chǎn)物不依賴顯卡驅(qū)動里的圖形庫也不會拉取任何 GUI 依賴。macOSApple Siliconbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON cmake --build build --target macos_app cmake --build build --target macos_dmgmacOS 這邊有個特殊之處它只有一個后端所以構(gòu)建目錄是統(tǒng)一的build/沒有build_vulkan/一說。產(chǎn)物除了build/spirula之外還會打包出可雙擊的Spirula Studio.app和.dmg磁盤映像。Spirula Studio 無頭部署與遠(yuǎn)程 GPU 訓(xùn)練 兩種很常見的用法放在一起說遠(yuǎn)程 GPU 服務(wù)器在服務(wù)器上跑spirula train它默認(rèn)會在一個 HTTP 端口上提供 3D 預(yù)覽頁面本地用ssh -L轉(zhuǎn)發(fā)端口后瀏覽器里就能看到訓(xùn)練進(jìn)度——服務(wù)器本身不必裝圖形環(huán)境純無頭構(gòu)建構(gòu)建階段加-DSS_BUILD_GUIOFF產(chǎn)物只有命令行工具更輕、依賴更少。關(guān)鍵開關(guān)-DSS_ENABLE_PATENTEDON 到底做什么 上面每條命令都帶了-DSS_ENABLE_PATENTEDON。它開啟進(jìn)程內(nèi) GPU 視頻解碼啟用后抽幀速度快約 15 倍系統(tǒng)側(cè)也不需要調(diào)用 ffmpeg不啟用時抽幀會回退到系統(tǒng)的 ffmpeg。為什么這個開關(guān)默認(rèn)關(guān)著因?yàn)樯婕?H.264 / H.265 / AV1 編解碼解析邏輯存在第三方專利授權(quán)問題是否開啟請自行確認(rèn)所在地區(qū)的合規(guī)要求。原理細(xì)節(jié)見 docs/build.md。Spirula Studio 安裝驗(yàn)證跑這兩條命令確認(rèn)構(gòu)建或安裝完成后打開終端執(zhí)行spirula --version spirula --helpWindows 下對應(yīng)spirula.exe --version與spirula.exe --help。兩條命令都能正常應(yīng)答說明安裝完成。再直接敲spirula而不帶任何參數(shù)它會直接進(jìn)入圖形界面左側(cè)是數(shù)據(jù)集選擇與訓(xùn)練參數(shù)面板中間是 3D 預(yù)覽區(qū)看到它們就穩(wěn)了。Spirula Studio 構(gòu)建報(bào)錯速查你大概率會碰上的幾個問題 Windows 報(bào)vcvars64.bat not found說明 VS 里沒裝 C 桌面開發(fā)的工作負(fù)載。在 VS 中補(bǔ)裝它或者直接改用開發(fā)者命令提示符運(yùn)行構(gòu)建腳本會自動探測 VS 的安裝位置。Vulkan 后端 CMake 配置失敗原因多數(shù)是同一個Vulkan SDK 沒就位。在 Windows 或 Linux 上裝好它再重新配置macOS 則無需任何 SDK。斷網(wǎng)時 GUI 構(gòu)建失敗GUI 首次構(gòu)建需要聯(lián)網(wǎng)下載 GLFW 與 Dear ImGui一次性。完全離線的環(huán)境加-DSS_BUILD_GUIOFF繞過即可。并行編譯被 OOM 殺掉不用自己加-j。構(gòu)建腳本啟動前會估算可用內(nèi)存并換算出并發(fā)數(shù)按約 750MB/任務(wù)計(jì)不會超出機(jī)器承受能力。macOS 上網(wǎng)格化只跑單核OpenMP 沒被找到。先brew install libomp——它是 keg-only 的CMake 默認(rèn)找不到而構(gòu)建腳本會自動探測到該庫的所在位置并傳給 CMake。nvcc 編譯報(bào)錯CUDA 版本與編譯器不匹配。腳本默認(rèn)挑機(jī)器里裝的最新版 CUDA不是你想要的那一個時傳-DCMAKE_CUDA_COMPILER...指定別家版本。中文路徑顯示為方塊全量 CJK 字體還沒下載。首次用到中文時 GUI 會提示你下載并緩存屬正常行為。裝完之后丟素材進(jìn)去就能訓(xùn)練到這一步把照片或視頻放進(jìn)數(shù)據(jù)集目錄即可——內(nèi)置 SfM 會先做完重建再直接開訓(xùn)任何外部工具都不必再裝。想再深入一點(diǎn)全部構(gòu)建選項(xiàng)見 cmake/SsOptions.cmake雙后端架構(gòu)設(shè)計(jì)見 docs/backends.md兩個入口腳本是 build_develop.bash 與 build_develop.bat?！久赓M(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 安裝教程：三步在 Windows、Linux 與 macOS 上跑通 3DGS 訓(xùn)練
Spirula Studio 安裝教程三步在 Windows、Linux 與 macOS 上跑通 3DGS 訓(xùn)練【免費(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先說好我不打算一上來講架構(gòu)咱們先把軟件跑起來跑的時候順便把每步為什么這么做講清楚。Spirula Studio 是一個開源的 3D 高斯?jié)姙R3D Gaussian Splatting訓(xùn)練工具Python、PyTorch、COLMAP 這些統(tǒng)統(tǒng)不用裝輸入素材 → splat 模型 → 帶紋理網(wǎng)格整條鏈路被塞進(jìn)一個自包含的二進(jìn)制里。因此 Spirula Studio 安裝這件事相當(dāng)輕整篇教程其實(shí)只回答兩個問題你要現(xiàn)成包還是自己編你的顯卡是 NVIDIA 還是別的先拿現(xiàn)成包三步啟動最省事的路線三步進(jìn) Releases 發(fā)布頁按你的系統(tǒng)Windows / Linux / macOS取對應(yīng)安裝包解壓雙擊啟動 GUI選數(shù)據(jù)集開訓(xùn)。完事。如果你在用一臺不帶顯示器的機(jī)器比如遠(yuǎn)程服務(wù)器同一套二進(jìn)制也帶命令行模式怎么部署看下面無頭與遠(yuǎn)程那一節(jié)。源碼路線一Vulkan 還是 CUDA先選計(jì)算后端現(xiàn)成包對不上你的環(huán)境或者想開關(guān)某些功能時走源碼構(gòu)建。動手前先回答后端問題。**Vulkan推薦**是跨廠商路線NVIDIA 與 AMD也包括 Intel 和 Apple 的顯卡都能跑且是 macOS 上唯一的選擇。它的構(gòu)建更快、二進(jìn)制更小SfM 重建、視頻抽幀和 AI 分割也一并打包在內(nèi)不必另配外部工具。Windows 和 Linux 上要先裝 Vulkan SDKmacOS 可以跳過這一步——CMake 會自動獲取 MoltenVK 并做靜態(tài)鏈接編出的二進(jìn)制拷到任何一臺 Mac 都能直接跑。CUDA則是 NVIDIA 專屬的傳統(tǒng)路線需要裝 CUDA 工具包Windows 與 Linux 支持macOS 不支持。兩者在訓(xùn)練與網(wǎng)格化上的功能完全一致速度差距通常只有幾個百分點(diǎn)按機(jī)器里插的什么卡選就行。后端定了之后三個平臺的依賴大同小異列給你編譯器Windows 用 Visual Studio 2022含 C 工具集或 GCC/ClangLinux 用 gcc/gmacOS 用 Xcode 命令行工具CMake NinjaVS 里一般自帶腳本會自己找Linux 與 macOS 需要自行安裝Vulkan SDKVulkan 后端在 Windows 與 Linux 上必備macOS 不需要CUDA 工具包僅 CUDA 后端要macOS 不支持python3可選。缺失時代碼生成步驟會被跳過生成文件已隨倉庫提交沒有 python3 照樣能構(gòu)建。源碼路線二三個平臺的構(gòu)建命令克隆一次代碼即可git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studioWindowsMSVC在cmd或開發(fā)者命令提示符里執(zhí)行.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功的產(chǎn)物是build_vulkan\spirula.exe。想走 CUDA 后端把命令里的-DSS_BACKENDvulkan換成-DSS_BACKENDcuda最終產(chǎn)物變?yōu)閎uild_cuda\spirula.exe。兩個細(xì)節(jié)腳本會自己通過 vswhere 找到 VS 并調(diào)用 vcvars64CMake/Ninja 不在 PATH 時則回退到 VS 自帶的版本。另外別自己帶-B——構(gòu)建目錄由腳本按后端名取改了對不上。Linuxbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功產(chǎn)物為build_vulkan/spirula。無顯示器的服務(wù)器加-DSS_BUILD_GUIOFF只出命令行工具——產(chǎn)物不依賴顯卡驅(qū)動里的圖形庫也不會拉取任何 GUI 依賴。macOSApple Siliconbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON cmake --build build --target macos_app cmake --build build --target macos_dmgmacOS 這邊有個特殊之處它只有一個后端所以構(gòu)建目錄是統(tǒng)一的build/沒有build_vulkan/一說。產(chǎn)物除了build/spirula之外還會打包出可雙擊的Spirula Studio.app和.dmg磁盤映像。Spirula Studio 無頭部署與遠(yuǎn)程 GPU 訓(xùn)練 兩種很常見的用法放在一起說遠(yuǎn)程 GPU 服務(wù)器在服務(wù)器上跑spirula train它默認(rèn)會在一個 HTTP 端口上提供 3D 預(yù)覽頁面本地用ssh -L轉(zhuǎn)發(fā)端口后瀏覽器里就能看到訓(xùn)練進(jìn)度——服務(wù)器本身不必裝圖形環(huán)境純無頭構(gòu)建構(gòu)建階段加-DSS_BUILD_GUIOFF產(chǎn)物只有命令行工具更輕、依賴更少。關(guān)鍵開關(guān)-DSS_ENABLE_PATENTEDON 到底做什么 上面每條命令都帶了-DSS_ENABLE_PATENTEDON。它開啟進(jìn)程內(nèi) GPU 視頻解碼啟用后抽幀速度快約 15 倍系統(tǒng)側(cè)也不需要調(diào)用 ffmpeg不啟用時抽幀會回退到系統(tǒng)的 ffmpeg。為什么這個開關(guān)默認(rèn)關(guān)著因?yàn)樯婕?H.264 / H.265 / AV1 編解碼解析邏輯存在第三方專利授權(quán)問題是否開啟請自行確認(rèn)所在地區(qū)的合規(guī)要求。原理細(xì)節(jié)見 docs/build.md。Spirula Studio 安裝驗(yàn)證跑這兩條命令確認(rèn)構(gòu)建或安裝完成后打開終端執(zhí)行spirula --version spirula --helpWindows 下對應(yīng)spirula.exe --version與spirula.exe --help。兩條命令都能正常應(yīng)答說明安裝完成。再直接敲spirula而不帶任何參數(shù)它會直接進(jìn)入圖形界面左側(cè)是數(shù)據(jù)集選擇與訓(xùn)練參數(shù)面板中間是 3D 預(yù)覽區(qū)看到它們就穩(wěn)了。Spirula Studio 構(gòu)建報(bào)錯速查你大概率會碰上的幾個問題 Windows 報(bào)vcvars64.bat not found說明 VS 里沒裝 C 桌面開發(fā)的工作負(fù)載。在 VS 中補(bǔ)裝它或者直接改用開發(fā)者命令提示符運(yùn)行構(gòu)建腳本會自動探測 VS 的安裝位置。Vulkan 后端 CMake 配置失敗原因多數(shù)是同一個Vulkan SDK 沒就位。在 Windows 或 Linux 上裝好它再重新配置macOS 則無需任何 SDK。斷網(wǎng)時 GUI 構(gòu)建失敗GUI 首次構(gòu)建需要聯(lián)網(wǎng)下載 GLFW 與 Dear ImGui一次性。完全離線的環(huán)境加-DSS_BUILD_GUIOFF繞過即可。并行編譯被 OOM 殺掉不用自己加-j。構(gòu)建腳本啟動前會估算可用內(nèi)存并換算出并發(fā)數(shù)按約 750MB/任務(wù)計(jì)不會超出機(jī)器承受能力。macOS 上網(wǎng)格化只跑單核OpenMP 沒被找到。先brew install libomp——它是 keg-only 的CMake 默認(rèn)找不到而構(gòu)建腳本會自動探測到該庫的所在位置并傳給 CMake。nvcc 編譯報(bào)錯CUDA 版本與編譯器不匹配。腳本默認(rèn)挑機(jī)器里裝的最新版 CUDA不是你想要的那一個時傳-DCMAKE_CUDA_COMPILER...指定別家版本。中文路徑顯示為方塊全量 CJK 字體還沒下載。首次用到中文時 GUI 會提示你下載并緩存屬正常行為。裝完之后丟素材進(jìn)去就能訓(xùn)練到這一步把照片或視頻放進(jìn)數(shù)據(jù)集目錄即可——內(nèi)置 SfM 會先做完重建再直接開訓(xùn)任何外部工具都不必再裝。想再深入一點(diǎn)全部構(gòu)建選項(xiàng)見 cmake/SsOptions.cmake雙后端架構(gòu)設(shè)計(jì)見 docs/backends.md兩個入口腳本是 build_develop.bash 與 build_develop.bat?！久赓M(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），僅供參考