Instructions to use peaes/GeoWorld with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use peaes/GeoWorld with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("peaes/GeoWorld", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
Upload folder using huggingface_hub
Browse files- .gitattributes +35 -35
- README.md +27 -27
- geoworld_stage1/optimizer.bin +3 -0
- geoworld_stage1/random_states_0.pkl +3 -0
- geoworld_stage1/sampler_pos_start.pkl +3 -0
- geoworld_stage1/scheduler.bin +3 -0
- geoworld_stage1/transformer/config.json +32 -0
- geoworld_stage1/transformer/diffusion_pytorch_model.safetensors +3 -0
- geoworld_stage2/optimizer.bin +3 -0
- geoworld_stage2/random_states_0.pkl +3 -0
- geoworld_stage2/sampler_pos_start.pkl +3 -0
- geoworld_stage2/scheduler.bin +3 -0
- geoworld_stage2/transformer/config.json +32 -0
- geoworld_stage2/transformer/diffusion_pytorch_model.safetensors +3 -0
.gitattributes
CHANGED
|
@@ -1,35 +1,35 @@
|
|
| 1 |
-
*.7z filter=lfs diff=lfs merge=lfs -text
|
| 2 |
-
*.arrow filter=lfs diff=lfs merge=lfs -text
|
| 3 |
-
*.bin filter=lfs diff=lfs merge=lfs -text
|
| 4 |
-
*.bz2 filter=lfs diff=lfs merge=lfs -text
|
| 5 |
-
*.ckpt filter=lfs diff=lfs merge=lfs -text
|
| 6 |
-
*.ftz filter=lfs diff=lfs merge=lfs -text
|
| 7 |
-
*.gz filter=lfs diff=lfs merge=lfs -text
|
| 8 |
-
*.h5 filter=lfs diff=lfs merge=lfs -text
|
| 9 |
-
*.joblib filter=lfs diff=lfs merge=lfs -text
|
| 10 |
-
*.lfs.* filter=lfs diff=lfs merge=lfs -text
|
| 11 |
-
*.mlmodel filter=lfs diff=lfs merge=lfs -text
|
| 12 |
-
*.model filter=lfs diff=lfs merge=lfs -text
|
| 13 |
-
*.msgpack filter=lfs diff=lfs merge=lfs -text
|
| 14 |
-
*.npy filter=lfs diff=lfs merge=lfs -text
|
| 15 |
-
*.npz filter=lfs diff=lfs merge=lfs -text
|
| 16 |
-
*.onnx filter=lfs diff=lfs merge=lfs -text
|
| 17 |
-
*.ot filter=lfs diff=lfs merge=lfs -text
|
| 18 |
-
*.parquet filter=lfs diff=lfs merge=lfs -text
|
| 19 |
-
*.pb filter=lfs diff=lfs merge=lfs -text
|
| 20 |
-
*.pickle filter=lfs diff=lfs merge=lfs -text
|
| 21 |
-
*.pkl filter=lfs diff=lfs merge=lfs -text
|
| 22 |
-
*.pt filter=lfs diff=lfs merge=lfs -text
|
| 23 |
-
*.pth filter=lfs diff=lfs merge=lfs -text
|
| 24 |
-
*.rar filter=lfs diff=lfs merge=lfs -text
|
| 25 |
-
*.safetensors filter=lfs diff=lfs merge=lfs -text
|
| 26 |
-
saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
| 27 |
-
*.tar.* filter=lfs diff=lfs merge=lfs -text
|
| 28 |
-
*.tar filter=lfs diff=lfs merge=lfs -text
|
| 29 |
-
*.tflite filter=lfs diff=lfs merge=lfs -text
|
| 30 |
-
*.tgz filter=lfs diff=lfs merge=lfs -text
|
| 31 |
-
*.wasm filter=lfs diff=lfs merge=lfs -text
|
| 32 |
-
*.xz filter=lfs diff=lfs merge=lfs -text
|
| 33 |
-
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
-
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
-
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
|
|
|
| 1 |
+
*.7z filter=lfs diff=lfs merge=lfs -text
|
| 2 |
+
*.arrow filter=lfs diff=lfs merge=lfs -text
|
| 3 |
+
*.bin filter=lfs diff=lfs merge=lfs -text
|
| 4 |
+
*.bz2 filter=lfs diff=lfs merge=lfs -text
|
| 5 |
+
*.ckpt filter=lfs diff=lfs merge=lfs -text
|
| 6 |
+
*.ftz filter=lfs diff=lfs merge=lfs -text
|
| 7 |
+
*.gz filter=lfs diff=lfs merge=lfs -text
|
| 8 |
+
*.h5 filter=lfs diff=lfs merge=lfs -text
|
| 9 |
+
*.joblib filter=lfs diff=lfs merge=lfs -text
|
| 10 |
+
*.lfs.* filter=lfs diff=lfs merge=lfs -text
|
| 11 |
+
*.mlmodel filter=lfs diff=lfs merge=lfs -text
|
| 12 |
+
*.model filter=lfs diff=lfs merge=lfs -text
|
| 13 |
+
*.msgpack filter=lfs diff=lfs merge=lfs -text
|
| 14 |
+
*.npy filter=lfs diff=lfs merge=lfs -text
|
| 15 |
+
*.npz filter=lfs diff=lfs merge=lfs -text
|
| 16 |
+
*.onnx filter=lfs diff=lfs merge=lfs -text
|
| 17 |
+
*.ot filter=lfs diff=lfs merge=lfs -text
|
| 18 |
+
*.parquet filter=lfs diff=lfs merge=lfs -text
|
| 19 |
+
*.pb filter=lfs diff=lfs merge=lfs -text
|
| 20 |
+
*.pickle filter=lfs diff=lfs merge=lfs -text
|
| 21 |
+
*.pkl filter=lfs diff=lfs merge=lfs -text
|
| 22 |
+
*.pt filter=lfs diff=lfs merge=lfs -text
|
| 23 |
+
*.pth filter=lfs diff=lfs merge=lfs -text
|
| 24 |
+
*.rar filter=lfs diff=lfs merge=lfs -text
|
| 25 |
+
*.safetensors filter=lfs diff=lfs merge=lfs -text
|
| 26 |
+
saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
| 27 |
+
*.tar.* filter=lfs diff=lfs merge=lfs -text
|
| 28 |
+
*.tar filter=lfs diff=lfs merge=lfs -text
|
| 29 |
+
*.tflite filter=lfs diff=lfs merge=lfs -text
|
| 30 |
+
*.tgz filter=lfs diff=lfs merge=lfs -text
|
| 31 |
+
*.wasm filter=lfs diff=lfs merge=lfs -text
|
| 32 |
+
*.xz filter=lfs diff=lfs merge=lfs -text
|
| 33 |
+
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
+
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
+
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
README.md
CHANGED
|
@@ -1,28 +1,28 @@
|
|
| 1 |
-
---
|
| 2 |
-
license: apache-2.0
|
| 3 |
-
---
|
| 4 |
-
|
| 5 |
-
# GeoWorld: Providing Full-frame Geometry Features to Facilitate 3D Scene Generation
|
| 6 |
-
|
| 7 |
-
This repository contains the model weights for GeoWorld, presented in the paper [GeoWorld: Providing Full-frame Geometry Features to Facilitate 3D Scene Generation](https://huggingface.co/papers/2511.23191).
|
| 8 |
-
|
| 9 |
-
Authors: Yuhao Wan, Lijuan Liu, Jingzhi Zhou, Zihan Zhou, Xuying Zhang, Dongbo Zhang, Shaohui Jiao, Qibin Hou, Ming-Ming Cheng
|
| 10 |
-
|
| 11 |
-
[Project Page](https://peaes.github.io/GeoWorld/) | [Paper(arXiv)](https://arxiv.org/abs/2511.23191) | [Code](https://github.com/peaes/GeoWorld)
|
| 12 |
-
|
| 13 |
-
TL;DR: GeoWorld uses a two-stage video-generation pipeline with full-frame geometry features to produce high-fidelity image-to-3D scenes faster than prior methods (7.5× faster than Hunyuan-Voyager).
|
| 14 |
-
|
| 15 |
-
## Usage
|
| 16 |
-
|
| 17 |
-
Please refer to the [official GitHub repository](https://github.com/peaes/GeoWorld) for installation instructions.
|
| 18 |
-
|
| 19 |
-
## Citation
|
| 20 |
-
|
| 21 |
-
```bibtex
|
| 22 |
-
@article{wan2025geoworld,
|
| 23 |
-
title={GeoWorld: Unlocking the Potential of Geometry Models to Facilitate High-Fidelity 3D Scene Generation},
|
| 24 |
-
author={Wan, Yuhao and Liu, Lijuan and Zhou, Jingzhi and Zhou, Zihan and Zhang, Xuying and Zhang, Dongbo and Jiao, Shaohui and Hou, Qibin and Cheng, Ming-Ming},
|
| 25 |
-
journal={arXiv preprint arXiv:2511.23191},
|
| 26 |
-
year={2025}
|
| 27 |
-
}
|
| 28 |
```
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: apache-2.0
|
| 3 |
+
---
|
| 4 |
+
|
| 5 |
+
# GeoWorld: Providing Full-frame Geometry Features to Facilitate 3D Scene Generation
|
| 6 |
+
|
| 7 |
+
This repository contains the model weights for GeoWorld, presented in the paper [GeoWorld: Providing Full-frame Geometry Features to Facilitate 3D Scene Generation](https://huggingface.co/papers/2511.23191).
|
| 8 |
+
|
| 9 |
+
Authors: Yuhao Wan, Lijuan Liu, Jingzhi Zhou, Zihan Zhou, Xuying Zhang, Dongbo Zhang, Shaohui Jiao, Qibin Hou, Ming-Ming Cheng
|
| 10 |
+
|
| 11 |
+
[Project Page](https://peaes.github.io/GeoWorld/) | [Paper(arXiv)](https://arxiv.org/abs/2511.23191) | [Code](https://github.com/peaes/GeoWorld)
|
| 12 |
+
|
| 13 |
+
TL;DR: GeoWorld uses a two-stage video-generation pipeline with full-frame geometry features to produce high-fidelity image-to-3D scenes faster than prior methods (7.5× faster than Hunyuan-Voyager).
|
| 14 |
+
|
| 15 |
+
## Usage
|
| 16 |
+
|
| 17 |
+
Please refer to the [official GitHub repository](https://github.com/peaes/GeoWorld) for installation instructions.
|
| 18 |
+
|
| 19 |
+
## Citation
|
| 20 |
+
|
| 21 |
+
```bibtex
|
| 22 |
+
@article{wan2025geoworld,
|
| 23 |
+
title={GeoWorld: Unlocking the Potential of Geometry Models to Facilitate High-Fidelity 3D Scene Generation},
|
| 24 |
+
author={Wan, Yuhao and Liu, Lijuan and Zhou, Jingzhi and Zhou, Zihan and Zhang, Xuying and Zhang, Dongbo and Jiao, Shaohui and Hou, Qibin and Cheng, Ming-Ming},
|
| 25 |
+
journal={arXiv preprint arXiv:2511.23191},
|
| 26 |
+
year={2025}
|
| 27 |
+
}
|
| 28 |
```
|
geoworld_stage1/optimizer.bin
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:9aabdf58d1e9e3d047f83fe597dbf1180f6fc20fcbfdab6c30cdebbe5732ad33
|
| 3 |
+
size 7989821315
|
geoworld_stage1/random_states_0.pkl
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:86084c37feb194195aee8c958f90082bc07fdcaf062a2c76f50d46214e0a3726
|
| 3 |
+
size 16100
|
geoworld_stage1/sampler_pos_start.pkl
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:103234403a64796bb0795a3d9d8dc4e2f1bad31e1fabb3a9d4357b58c6f1a276
|
| 3 |
+
size 21
|
geoworld_stage1/scheduler.bin
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:3f8a760a07ba028d3fadcd2a22e2b95312fc193710076a79cb74f12736f9bf5c
|
| 3 |
+
size 1064
|
geoworld_stage1/transformer/config.json
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"_class_name": "WanTransformer3DModelGeoWorldstage1",
|
| 3 |
+
"_diffusers_version": "0.32.2",
|
| 4 |
+
"add_control_adapter": false,
|
| 5 |
+
"add_ref_conv": true,
|
| 6 |
+
"cross_attn_norm": true,
|
| 7 |
+
"dim": 1536,
|
| 8 |
+
"eps": 1e-06,
|
| 9 |
+
"ffn_dim": 8960,
|
| 10 |
+
"freq_dim": 256,
|
| 11 |
+
"hidden_size": 1536,
|
| 12 |
+
"in_channels": 48,
|
| 13 |
+
"in_dim": 48,
|
| 14 |
+
"in_dim_control_adapter": 24,
|
| 15 |
+
"in_dim_ref_conv": 16,
|
| 16 |
+
"model_type": "i2v",
|
| 17 |
+
"num_heads": 12,
|
| 18 |
+
"num_layers": 30,
|
| 19 |
+
"out_dim": 16,
|
| 20 |
+
"patch_size": [
|
| 21 |
+
1,
|
| 22 |
+
2,
|
| 23 |
+
2
|
| 24 |
+
],
|
| 25 |
+
"qk_norm": true,
|
| 26 |
+
"text_dim": 4096,
|
| 27 |
+
"text_len": 512,
|
| 28 |
+
"window_size": [
|
| 29 |
+
-1,
|
| 30 |
+
-1
|
| 31 |
+
]
|
| 32 |
+
}
|
geoworld_stage1/transformer/diffusion_pytorch_model.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:26cac1916722bc13d01e01ce05dfbd693b97a100a6b33795f31d8a7cab423f2b
|
| 3 |
+
size 3994421776
|
geoworld_stage2/optimizer.bin
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:c334381f8448217d1673542eb0c850a79faa02631668531036ebc9fb90cbee04
|
| 3 |
+
size 7427107965
|
geoworld_stage2/random_states_0.pkl
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:7003d2fc2915dbc3df0c39fe3a6fb10f3371cd9ac3380cd9e3be258c365ce9bf
|
| 3 |
+
size 16100
|
geoworld_stage2/sampler_pos_start.pkl
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:2841cfee1925eba786b24a041aff28d246b4e0184cf8338932ef4fe9effd5cd6
|
| 3 |
+
size 21
|
geoworld_stage2/scheduler.bin
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:4387405ca0cb211e68236052f0b68d4deae41c65cf0b7063ad12a92ed50d22e9
|
| 3 |
+
size 1064
|
geoworld_stage2/transformer/config.json
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"_class_name": "WanTransformer3DModelGeoWorldstage2",
|
| 3 |
+
"_diffusers_version": "0.32.2",
|
| 4 |
+
"add_control_adapter": false,
|
| 5 |
+
"add_ref_conv": true,
|
| 6 |
+
"cross_attn_norm": true,
|
| 7 |
+
"dim": 1536,
|
| 8 |
+
"eps": 1e-06,
|
| 9 |
+
"ffn_dim": 8960,
|
| 10 |
+
"freq_dim": 256,
|
| 11 |
+
"hidden_size": 1536,
|
| 12 |
+
"in_channels": 48,
|
| 13 |
+
"in_dim": 48,
|
| 14 |
+
"in_dim_control_adapter": 24,
|
| 15 |
+
"in_dim_ref_conv": 16,
|
| 16 |
+
"model_type": "i2v",
|
| 17 |
+
"num_heads": 12,
|
| 18 |
+
"num_layers": 30,
|
| 19 |
+
"out_dim": 16,
|
| 20 |
+
"patch_size": [
|
| 21 |
+
1,
|
| 22 |
+
2,
|
| 23 |
+
2
|
| 24 |
+
],
|
| 25 |
+
"qk_norm": true,
|
| 26 |
+
"text_dim": 4096,
|
| 27 |
+
"text_len": 512,
|
| 28 |
+
"window_size": [
|
| 29 |
+
-1,
|
| 30 |
+
-1
|
| 31 |
+
]
|
| 32 |
+
}
|
geoworld_stage2/transformer/diffusion_pytorch_model.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:ababbffb1d0fd6520af68af8992308c03f744d4c7b5a913d2fa88064dbdc8935
|
| 3 |
+
size 3713112914
|