cube

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

Cube 是一个面向 3D 智能的 Roblox 基础模型，旨在让开发者通过自然语言或简单输入直接生成、编辑和交互 3D 内容。它解决了传统 3D 建模门槛高、流程复杂的问题，将 AI 能力引入 Roblox 生态，支持从文本/图像到 3D 资产的生成、场景理解与编辑等核心功能。项目基于 Jupyter Notebook 提供示例和训练流程，适合研究者和开发者快速上手，探索 3D 生成式 AI 在游戏和虚拟世界中的应用。

开源 free 数字人3D

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1254

维护状态低维护

是否开源是

定价模式 free

项目数据

分类数字人3D

开发团队Roblox

所属国家

官网地址

GitHubhttps://github.com/Roblox/cube

定价模式free

价格说明开源项目，无官网，需自行部署，完全免费。

访问状态

是否开源是

开源协议NOASSERTION

主要语言Jupyter Notebook

技术栈/模型3d,3d-aigc,3d-generation,shape-generation,text-to-3d

GitHub 星标★ 1254

30天Star增速

HF 下载量

上线时间2025-03-11 00:00:00

最近更新2026-09-23 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数22

使用教程

难度：进阶约 25 分钟部署方式：库/依赖 6 步

环境要求

已安装 git 与 Python/pip 的本地环境
README 要求在虚拟环境中安装本项目
GPU 场景需 PyTorch 支持（Windows 需 CUDA toolkit，MacOS/AMD 可用 MPS 后端）
推理显存占用与 resolution_base 相关，显存不足时需调小

安装与启动步骤

1克隆仓库

把 Roblox/cube 仓库拉取到本地，需已装 git 且能访问 GitHub。
```
git clone https://github.com/Roblox/cube.git
```
2进入项目目录

切换到克隆得到的 cube 目录，后续安装命令都在该目录下执行。
```
cd cube
```
3准备虚拟环境

README 要求在虚拟环境中安装，请先自行创建并激活 venv 或 conda 环境再继续。
4安装项目依赖

以可编辑模式安装 cube 及其依赖，[meshlab] 为可选附加依赖，安装耗时较长。
```
pip install -e .[meshlab]
```
5配置 CUDA 版 PyTorch

Windows 且需要 GPU 加速时执行，安装带 CUDA 支持的 torch；README 注明按需强制重装。
```
pip install torch --index-url https://download.pytorch.org/whl/cu124 --force-reinstall
```
6验证导入

执行 README 示例里的导入语句，能成功导入即说明库已安装可用。
```
python -c 'import torch, trimesh; from cube3d.inference.engine import Engine, EngineFast'
```

关键配置

配置项	必填	说明	示例
`resolution_base`	否	推理分辨率基数，调小可加快推理并降低显存占用	`README 未给出具体示例值`

如何确认成功

执行 python -c 'from cube3d.inference.engine import Engine, EngineFast' 能成功导入、无报错，即表示安装完成。

常见问题

Q：安装时 meshlab 依赖报错怎么办？

A：README 说明 [meshlab] 是可选依赖，改成 pip install -e . 即可获得更好的兼容性，但网格简化功能会被禁用。

Q：Windows 上 torch 没有 CUDA 支持怎么办？

A：按 README 提示先安装 CUDA toolkit，再用 pip install torch --index-url https://download.pytorch.org/whl/cu124 --force-reinstall 重装 torch。

Q：Apple Silicon 或 AMD 显卡能用吗？

A：可以。README 指出这类系统可使用 PyTorch 的 Metal Performance Shaders（MPS）后端。

Q：推理时显存不够怎么办？

A：README 建议调小 resolution_base，以获得更快的推理速度和更低的显存占用。

注意事项

本项目以 Python 库方式使用（README 示例为 import cube3d.inference.engine 中的 Engine 与 EngineFast）。
README 明确要求在虚拟环境中克隆并安装本仓库。
[meshlab] 为可选依赖，去掉后网格简化功能将不可用。
仓库同时提供 Jupyter Notebook 形式的示例，便于研究参考。

核心亮点

直接对接 Roblox 生态，生成的 3D 资产可无缝用于游戏开发
支持多模态输入（文本/图像），降低 3D 创作门槛
提供 Jupyter Notebook 示例，便于研究复现和二次开发

不足之处

项目处于早期，文档和社区支持待观察
依赖 Roblox 平台，通用性受限

适用场景

游戏开发者快速生成 3D 道具或场景原型
AI 研究者探索 3D 生成模型在虚拟世界中的应用
Roblox 创作者自动化内容生产，提升效率

替代项目

Point-E、Shap-E、DreamFusion

项目介绍

cube 是数字人3D领域的开源项目，由 Roblox 开发，2025 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（1,254）位列前 30%，在数字人3D分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,228 增加到 1,254，净增 26。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。无官网，需自行部署，完全免费。

它主要面向的使用场景是：游戏开发者快速生成3D道具或场景原型。同类可对比的替代方案包括 Point-E、Shap-E、DreamFusion。

上一篇：Direct3D-S2

下一篇：AvatarCLIP