text2room

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 图像生成 🍴 复刻 73 🐛 待处理 1 👀 关注 11
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1095
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,免费使用,需自行部署。

项目预览

text2room 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类图像生成
开发团队lukasHoel
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,免费使用,需自行部署。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型3d-generation,diffusion-models,mesh-generation,text-to-image
GitHub 星标★ 1095
上线时间2023-03-21 00:00:00
代码更新2023-11-15
仓库体积9.1 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1095

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:高级 约 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

上一篇:chat-with-nerf

下一篇:banana-levelup

同类项目推荐

GameFactory-3A 开源

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

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

★ 1013 2026-08-21
Director3D 开源

输入一句话,自动生成真实3D场景和相机运镜视频

Code for "Director3D: Real-world Camera Trajectory and 3D Scene Generation from Text···

★ 382 2026-08-09
tet-splatting 开源

用四面体溅射技术,快速生成高质量3D模型。

[NeurIPS 2024 Spotlight] Tetrahedron Splatting for 3D Generation

★ 180 2026-08-09
sem2nerf 开源

一张语义图,直接生成可多视角观看的三维场景

[ECCV'22] Sem2NeRF: Converting Single-View Semantic Masks to NeRFs

★ 127 2026-08-09
SGAM_NeurIPS22 开源

一张图生成连贯3D世界,生成与映射同步搞定

[NeurIPS 2022] SGAM: Building a Virtual 3D World through Simultaneous Generation and···

★ 63 2026-08-09
TripoSF 开源

从稀疏输入生成高分辨率、任意拓扑的 3D 模型

SparseFlex: High-Resolution and Arbitrary-Topology 3D Shape Modeling

★ 778 2026-08-09
Awesome-Gaussian-Skills 开源

3D图形学论文+AI技能,一键调用加速研究

1000+ arXiv-verified 3DGS methods · 15 AI agent skills · MCP server (34 tools) · ···

★ 180 2026-08-09
awesome-avatar-plaza 开源

每日追踪数字人前沿论文,快速掌握最新技术动态

Daily tracking of awesome avatar papers, including 2d talking head, 3d head avatar, ···

★ 76 2026-08-09