text2room

输入一句话,直接生成可探索的 3D 室内房间

Text2Room 是一个利用 2D 文本生成图像模型来创建带纹理 3D 网格的开源项目,出自 ICCV2023。它解决了从单一文本提示直接生成连贯、可探索的 3D 室内场景的难题。核心能力在于通过迭代的视角合成和融合策略,将多张 2D 图像映射到 3D 空间,生成具有几何结构和纹理的完整房间网格。项目支持从文本提示生成不同风格的室内场景,输出可直接用于渲染或后续编辑的 3D 资产。其技术栈涉及扩散模型、网格生成和 3D 生成,为文本到 3D 领域提供了实用的开源实现。

开源 free 图像生成
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1090
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类图像生成
开发团队lukasHoel
所属国家
定价模式free
价格说明开源项目,MIT许可证,免费使用,需自行部署。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型3d-generation,diffusion-models,mesh-generation,text-to-image
GitHub 星标★ 1090
30天Star增速
HF 下载量
上线时间2023-03-21 00:00:00
最近更新2026-09-13 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数4

使用教程

难度:高级 约 30 分钟 部署方式:本地安装 7 步

环境要求

  • Linux 环境(README 示例基于 Linux,CUDA 11.7)
  • Conda 环境管理器
  • Python 3.9(README 指定版本)
  • PyTorch 1.13.1 + Pytorch3D 0.7.2(README 测试组合)
  • 可访问 GitHub 与 conda 源以拉取依赖

安装与启动步骤

  1. 1克隆仓库

    把 Text2Room 源码下载到本地,后续的 requirements.txt 位于仓库根目录,需在该目录执行安装命令。

    git clone https://github.com/lukasHoel/text2room.git
  2. 2创建 conda 环境

    按 README 要求创建名为 text2room 的 Python 3.9 环境,环境名需与后续激活命令一致。

    conda create -n text2room python=3.9
  3. 3激活环境

    切换到刚创建的环境,之后所有 pip/conda 安装都应在此环境内进行。

    conda activate text2room
  4. 4安装 Python 依赖

    在仓库根目录执行,安装 README 列出的全部 Python 依赖包。

    pip install -r requirements.txt
  5. 5装 Pytorch3D 前置

    README 建议先通过 conda 安装 fvcore 与 iopath,它们是 Pytorch3D 的依赖。

    conda install -c fvcore -c iopath -c conda-forge fvcore iopath
  6. 6安装 Pytorch3D

    按 Pytorch3D 官方说明安装;README 测试组合为 PyTorch 1.13.1、CUDA 11.7、Pytorch3D 0.7.2。

    pip install "git+https://github.com/facebookresearch/pytorch3d.git@stable"
  7. 7下载预训练权重

    README 要求下载 fixed depth inpainting 模型的预训练权重,但节选内容在此处中断,未给出完整命令与链接,请查阅仓库原文。

如何确认成功

环境创建、requirements 依赖与 Pytorch3D 安装均无报错即准备完成;README 未提供运行/启动命令。

常见问题

Q:Pytorch3D 安装失败怎么办?

A:README 指向 Pytorch3D 官方安装文档,并给出 tested 组合:PyTorch 1.13.1、CUDA 11.7、Pytorch3D 0.7.2,建议按该组合对齐版本后重试。

Q:必须用 Conda 吗?

A:README 的安装流程以 conda 创建 Python 3.9 环境开始,用 conda 最容易复现其环境。

Q:预训练权重在哪里下载?

A:README 提到需下载 fixed depth inpainting 模型的预训练权重,但提供的节选未包含完整下载链接与命令,请以仓库原文为准。

Q:Windows 能用吗?

A:README 的安装示例标注为 Linux 下测试(CUDA 11.7),未说明 Windows 支持情况,建议在 Linux 下部署。

注意事项

  • README 节选在下载预训练权重处截断,权重链接与后续运行命令未给出,需查看仓库原文补全。
  • Pytorch3D 需自行编译,对 PyTorch/CUDA 版本敏感,务必按 README 标注的版本组合安装。
  • conda 环境名固定为 text2room,后续激活与环境相关命令请保持一致。
  • 全部命令需在仓库根目录或已激活的 text2room 环境中执行,避免装到 base 环境。

核心亮点

  • 基于 ICCV2023 论文,方法有学术支撑,生成效果有保障
  • 提供完整训练和推理代码,便于复现和二次开发
  • 支持自定义文本提示,灵活生成多样室内风格

不足之处

  • 生成分辨率受限于 2D 模型,纹理细节可能模糊
  • 对复杂场景或非室内主题支持有限
  • 文档/社区待观察

适用场景

  • 游戏和影视中的快速场景原型设计
  • 室内设计行业的概念可视化
  • VR/AR 内容的自动内容生成

替代项目

DreamFusion、Magic3D、Text2Mesh

项目介绍

text2room 是数字人3D领域的开源项目,由 lukasHoel 开发,2023 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(1,090)位列前 30%,在数字人3D分类中处于中上游。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-13。MIT许可证,免费使用,需自行部署。

它主要面向的使用场景是:游戏和影视中的快速场景原型设计。同类可对比的替代方案包括 DreamFusion、Magic3D、Text2Mesh。

上一篇:chat-with-nerf

下一篇:banana-levelup

同类项目推荐

A3D 开源

在 three.js 里直接调用 AI 生成纹理和素材,边建模边生成

3D x AI hybrid editor, built with three.js

★ 129 2026-08-09
cube 开源

用一句话生成 3D 模型,在 Roblox 里快速落地 AI 创作

Roblox Foundation Model for 3D Intelligence

★ 1254 2026-08-09
AG3D 开源

用2D图片直接生成3D虚拟人,告别昂贵扫描

Official code release for ICCV2023 paper AG3D: Learning to Generate 3D Avatars from ···

★ 273 2026-08-09
GameFactory-3A 开源

一条命令生成 3A 游戏资产,从模型到视频全自动

A comprehensive open-source 3A game-generation skill and asset framework.

★ 778 2026-08-21