Infinigen 安装完全指南：Python 包、Blender 内嵌与 Docker 三种部署方式详解

计算机视觉数据增强媒体生成【免费下载链接】infinigenInfinite Photorealistic Worlds using Procedural Generation项目地址https://gitcode.com/gh_mirrors/in/infinigen点击查看免费下载导读Infinigen 是普林斯顿大学视觉实验室开源的程序化三维场景生成器可生成无限逼真的自然场景、室内场景与仿真资产。本文将基于官方 Installation.md 文档并结合仓库内 setup.py、pyproject.toml 等真实源码完整讲解三种安装路线Python 包安装默认、无头执行、Blender 内嵌 Python 安装可在 Blender UI 中交互使用以及Docker 容器安装。读完本文你将能够根据自身硬件Linux / Mac / Windows / WSL2与功能需求Minimal / Terrain / CUDA / OpenGL / Fluid选择正确配置并成功跑通 Hello World 场景 与 Hello Room 场景。一、安装方式总览与平台支持矩阵Infinigen 提供两种安装形态二者核心区别在于infinigen包被装进哪个 Python 环境Python Module默认推荐只能无头headless执行无法打开 Blender 图形界面将infinigen包安装到用户自己的 Python 环境以 pip 依赖方式安装bpyBlender 的 Python 绑定对应 pyproject.toml 中的bpy4.2.0。Blender Python Script可以在 Blender UI 中交互式使用 Infinigen将infinigen包安装到Blender 自带的 Python 解释器中而非用户自己的 Python使用标准独立安装standalone的 Blender 程序。无论选择哪种方式不同操作系统对若干功能集的支持程度有差异官方支持矩阵如下功能集用于生成…Linux x86_64Mac x86_64Mac ARMWindows x86_64Windows WSL2 x86_64Minimal Install最小安装物体与材质支持支持支持实验性实验性Terrain (CPU)地形- CPU完整场景支持支持支持不支持实验性Terrain (CUDA)地形- GPU加速、更快出视频支持不支持不支持不支持实验性OpenGL Annotations额外的训练标注数据支持支持支持不支持实验性Fluid Simulation流体模拟火焰、模拟水面支持实验性实验性不支持实验性文档明确提示表中标为experimental的字段表示可行但未经测试且缺少文档标为no的字段则表示大体上可能实现但尚未落地。因此想运行 Hello World 演示生成完整自然场景或生成完整场景的用户应选择Python Module Terrain (CPU)想在 Blender UI 中使用 Infinigen 资产、或自行开发新资产的用户应选择Blender-Python 脚本 Minimal Install。其余可选功能相机配置、地面真值标注、流体模拟可参阅 Configuring Infinigen、Ground Truth Annotations 与 Generating Fluid Simulations。二、安装前的系统依赖Dependencies官方文档推荐先安装 anaconda 或 miniconda平台安装说明可参考 miniconda 官方文档然后按平台安装系统级依赖。Ubuntu / Debian / WSL 等 Linux 系sudo apt-get install wget cmake g libgles2-mesa-dev libglew-dev libglfw3-dev libglm-dev zlib1g-devMac ARMM1/M2/…arch -arm64 brew install wget cmake llvm open-mpi libomp glm glew zlibMac x86_64Intelbrew install wget cmake llvm open-mpi libomp glm glew zlib没有 sudo 权限时的 Conda 方案conda install conda-forge::gxx11.4.0 mesalib glew glm menpo::glfw3 export C_INCLUDE_PATH$CONDA_PREFIX/include:$C_INCLUDE_PATH export CPLUS_INCLUDE_PATH$CONDA_PREFIX/include:$CPLUS_INCLUDE_PATH export LIBRARY_PATH$CONDA_PREFIX/lib:$LIBRARY_PATH export LD_LIBRARY_PATH$CONDA_PREFIX/lib:$LD_LIBRARY_PATH源码佐证这些依赖正是编译期真正需要的。查看 compile_terrain.sh 可以看到地形组件需要g/clang、OpenMP-fopenmp、GLM 头文件-I../datagen/customgt/dependencies/glm等而 Dockerfile 中安装的libgles2-mesa-dev libglew-dev libglfw3-dev libglm-dev zlib1g-dev与上述清单完全对应说明这套依赖是构建链路的硬性要求。三、Python 包方式安装默认路线3.1 Developer Install完整开发安装官方推荐使用 uv 管理环境。安装 uv 后执行git clone https://github.com/princeton-vl/infinigen.git cd infinigen git submodule update --init uv venv uv pip install -e .[dev,terrain,vis] uv run pre-commit install这条命令实际做了三件事可以从 pyproject.toml 中拆解[dev]可选依赖pre-commit、pytest系列、ruff0.14.5、sphinx文档构建工具链等供开发者提交代码与跑测试使用[terrain]可选依赖infinigen[infinigen1]、landlab2.6.0、pyrender0.2.0、setuptools81landlab 仍依赖pkg_resources对应地形完整生成能力[vis]可选依赖einops、numba用于地面真值可视化、pyglet2供trimesh_scene.show()使用。同时注意 pyproject.toml 中的硬性约束requires-python 3.11.*即仅支持 Python 3.11核心依赖bpy4.2.0Blender 4.2 的 Python 绑定会在 pip 阶段自动拉入。3.2 Minimal Install最小安装如果不生成地形或 OpenGL 地面真值只做 Infinigen-Indoors室内或单物体生成官方提供最小安装以规避 C 编译与部分易出问题的依赖如 landlabINFINIGEN_MINIMAL_INSTALLTrue uv pip install -e .原理深入查看 setup.py 可知INFINIGEN_MINIMAL_INSTALL环境变量默认即为True第 22 行。当它为True时跳过ensure_submodules()不会自动拉取 .gitmodules 中声明的子模块infinigen_gpl、OcMesher以及 customgt 的 eigen/argparse/cnpy/glm/json/stb/glfw 等跳过make terrain、make customgt等原生编译步骤第 58-62 行不注册bnurbs与infinigen.terrain.marching_cubes两个 Cython 扩展第 66-84 行。因此 Minimal 模式既不碰 C 也不碰 Cython安装速度最快、依赖最少是室内与单体资产生成场景的推荐起点。3.3 Legacy (1.0) 生成管线安装仓库中infinigen_examples.generate_nature/generate_indoors属于遗留 1.0 管线需要额外的依赖与原生构建地形、marching_cubes扩展、git 子模块默认 2.0 安装不会带入。1.0 使用pip而非uv安装且必须先完成上文 系统依赖 部分git clone --recurse-submodules https://github.com/princeton-vl/infinigen.git cd infinigen conda create --name infinigen python3.11 conda activate infinigen INFINIGEN_MINIMAL_INSTALLFalse INFINIGEN_INSTALL_TERRAINTrue pip install -e .[infinigen1]如需额外编译 OpenGL 地面真值标注器在上述命令中再追加环境变量INFINIGEN_INSTALL_CUSTOMGTTrue pip install -e .[infinigen1]pyproject.toml 中[infinigen1]可选依赖解释了1.0 为什么要单独装它聚合了vis依赖以及gin_config0.5.0、coacd、networkx、psutil、scikit-learn1.4.0、shapely2.0.5、tqdm、submititv1 datagen 的 SLURM 提交等 1.0 专属依赖terrain可选依赖也正是建立在infinigen[infinigen1]之上的。安装报错时的标准排障姿势在命令末尾追加-vv logs.txt 21重新执行然后把生成的logs.txt作为附件提交到 GitHub Issue。四、安装到 Blender 内置 Python 解释器若要在 Blender UI 中交互使用 Infinigen或开发自己的资产需要把包装进 Blender 自带 Python。4.1 交互式安装脚本首先完成一次上文正常安装然后Linux / Mac / WSL 下执行git clone https://github.com/princeton-vl/infinigen.git INFINIGEN_MINIMAL_INSTALLTrue bash scripts/install/interactive_blender.sh剖析 interactive_blender.sh该脚本做了以下事情按平台确定下载链接并下载Blender 4.2.0Linux 为blender-4.2.0-linux-x64.tar.xzMac ARM 为blender-4.2.0-macos-arm64.dmgMac x86_64 为blender-4.2.0-macos-x64.dmg解压/挂载到仓库根目录下的blender/Linux或Blender.app/Mac用 Blender 内置解释器例如blender/4.2/python/bin/python3.11执行ensurepip然后以该解释器运行pip install -e .从而把infinigen包写入Blender 的 site-packages而非系统 Python全程set -e任一步骤失败立即终止。安装完成后可用辅助脚本启动 Blender UIpython -m infinigen.launch_blenderlaunch_blender.py 会在仓库根目录下依次查找blender/blender与Blender.app/Contents/MacOS/Blender找到后自动注入 blendscript_import_infinigen.py 完成包导入第 13-17、61 行若找不到可执行文件会抛出提示你补齐 Blender-Python 安装步骤的明确错误。4.2 Blender 模式下的命令改写规则重要警告如果你采用 Blender-Python 脚本方式安装文档中形如python -m MODULEPATH ARGUMENTS的命令不能直接照抄应改写为python -m infinigen.launch_blender -m MODULEPATH -- ARGUMENTS原因同样在 launch_blender.py-m参数会被翻译为--python 路径交给独立 Blender 的无头模式执行第 46-56 行即把模块当作脚本在 Blender 环境中运行而不是用系统 Python 运行。同样地出错时在命令末尾追加 logs.txt 21重跑并提交logs.txt到 Issue。五、在 Docker 容器中使用 Infinigen5.1 Linux 上的 Docker 工作流git clone https://github.com/princeton-vl/infinigen.git cd infinigen make docker-build make docker-setup make docker-run对应关系如下均来自 Makefile命令作用make docker-build以 miniconda3 为基础镜像构建默认 taginfinigen_docker_img镜像内创建infinigenconda 环境并执行pip install -e .[dev]见 Dockerfile 第 26-28 行make docker-build-cuda改用nvidia/cuda:12.0.0-devel-ubuntu22.04基础镜像开启 CUDA 地形编译make docker-setup配置 X11 转发安装x11-xserver-utils、生成 Xauthority 并xhost local:docker仅在需要 OpenGL 时必需make docker-run以--gpusall并挂载 X11 socket 与outputs目录启动容器自动回退到/dev/dri设备模式make docker-run-no-gpu不进行 GPU 直通make docker-run-no-opengl不带 OpenGL 地面真值make docker-run-no-gpu-opengl两者都关闭同时注入BLENDER/opt/infinigen/blender/blender环境变量注意事项不用 OpenGL 时可跳过make docker-setup用exit退出容器用docker exec -it infinigen bash重新进入每次运行场景前记得conda activate infinigen。5.2 Windows 上的 Docker 工作流先安装 WSL2 与 Docker Desktop并在设置中启用 Use the WSL 2 based engine...保持 Docker Desktop 打开然后按上述 Linux 流程执行即可。六、安装后的验证与下一步完成安装后可通过运行官方示例快速验证环境是否就绪自然场景首秀Hello World 演示对应 generate_nature.py需要 Terrain (CPU) 能力室内场景首秀Hello Room 演示对应 generate_indoors.pyMinimal 安装即可胜任生成单个资产Generating Individual Assets。仓库内置的测试亦可作为安装完整性的校验例如 tests/infinigen/core/test_gins.py 会校验各类 gin 配置在安装环境下的可解析性tests/infinigen2/test_generators.py 则验证 v2 生成器可正常导入运行——在dev依赖齐全的安装中可执行pytest tests跑完整测试套件。七、常见问题速查Q1一定要用 Python 3.11 吗是。requires-python 3.11.*是硬约束且bpy4.2.0、landlab2.6.0等核心依赖均针对 3.11 生态锁定版本。Q2Windows 原生支持吗Minimal 安装为实验性Terrain/CUDA/OpenGL 原生 Windows 均不支持推荐通过 WSL2 运行各功能集标为实验性或直接走 Docker 方案。Q3只想生成室内场景需要编译地形吗不需要。使用INFINIGEN_MINIMAL_INSTALLTrue uv pip install -e .即可室内与单物体生成不依赖地形 C 组件。Q4为什么文档中的python -m ...命令在 Blender 模式下不能直接用因为系统 Python 里没有 Blender 上下文。必须改写为python -m infinigen.launch_blender -m MODULEPATH -- ARGUMENTS由 launch_blender.py 转交给独立 Blender 执行。Q5安装/编译报错怎么办先确认系统依赖是否齐全见第二节再在命令末尾追加-vv logs.txt 21Blender 模式为 logs.txt 21重跑将logs.txt附带进 GitHub Issue 反馈。赞分享计算机视觉数据增强媒体生成【免费下载链接】infinigenInfinite Photorealistic Worlds using Procedural Generation项目地址https://gitcode.com/gh_mirrors/in/infinigen点击查看免费下载相关推荐Jellyfin Desktop 快速上手指南把媒体库直传到本地播放的开源桌面播放器Jellyfin Desktop 快速上手指南把媒体库直传到本地播放的开源桌面播放器 Jellyfin Desktop 是面向 Jellyfin 服务器的开源音视频桌面应用ChatLab 安装全指南Desktop、CLI 与 Docker 三种部署方式详解ChatLab 安装全指南Desktop、CLI 与 Docker 三种部署方式详解 ChatLab 是一款本地优先的 AI 聊天记录分析工具将聊天历史的解Pixelle-Video 安装部署全指南Windows 整合包、源码安装与 Docker 三种方式详解Pixelle Video 安装部署全指南Windows 整合包、源码安装与 Docker 三种方式详解 导读本文是 Pixelle VideoAI 全自人工智能AI 应用音视频媒体生成上一篇企业级应用的API安全gh_mirrors/ne/next-enterprise中的OAuth2实现下一篇PTO ISA 指令参考全解析CANN pto-isa 虚拟指令集体系与 v9.2.0 接口迁移指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考