Update README.md
Browse files
README.md
CHANGED
|
@@ -1,10 +1,48 @@
|
|
| 1 |
---
|
| 2 |
title: README
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
-
colorTo:
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
| 8 |
---
|
| 9 |
|
| 10 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
title: README
|
| 3 |
+
emoji: 🫧
|
| 4 |
+
colorFrom: indigo
|
| 5 |
+
colorTo: purple
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
| 8 |
---
|
| 9 |
|
| 10 |
+
# libgs
|
| 11 |
+
|
| 12 |
+
**[ffgs](https://github.com/libgs/ffgs)** — standard inference for feed-forward 3D
|
| 13 |
+
Gaussian Splatting models. Posed (or unposed) images in, 3D Gaussians out, behind
|
| 14 |
+
one `GSPipeline.from_pretrained` for every model.
|
| 15 |
+
|
| 16 |
+
```bash
|
| 17 |
+
pip install --pre ffgs # inference
|
| 18 |
+
pip install --pre "ffgs[render]" # + gsplat rasterisation (CUDA)
|
| 19 |
+
```
|
| 20 |
+
|
| 21 |
+
```python
|
| 22 |
+
from ffgs import GSPipeline, Views
|
| 23 |
+
|
| 24 |
+
pipe = GSPipeline.from_pretrained("anysplat/default", device="cuda")
|
| 25 |
+
out = pipe(Views(images)) # unposed images -> Gaussians + cameras
|
| 26 |
+
out.gaussians.save_ply("scene.ply") # standard 3DGS ply
|
| 27 |
+
```
|
| 28 |
+
|
| 29 |
+
## Models
|
| 30 |
+
|
| 31 |
+
ffgs loads the authors' own checkpoints from their Hub repos (pinned to a commit
|
| 32 |
+
and a sha256); it does not re-host weights.
|
| 33 |
+
|
| 34 |
+
| model | weights | poses | license (weights) |
|
| 35 |
+
|---|---|---|---|
|
| 36 |
+
| [TokenGS](https://arxiv.org/abs/2604.15239) | [jiaweir/tokengs](https://huggingface.co/jiaweir/tokengs) | required | NVIDIA research license (non-commercial) |
|
| 37 |
+
| [AnySplat](https://arxiv.org/abs/2505.23716) | [lhjiang/anysplat](https://huggingface.co/lhjiang/anysplat) | optional | non-commercial (fine-tuned from VGGT-1B, CC BY-NC 4.0) |
|
| 38 |
+
|
| 39 |
+
Each model's page — sources, zoo entries, usage, and agreement with the official
|
| 40 |
+
code: [docs/models](https://github.com/libgs/ffgs/blob/main/docs/models/index.md).
|
| 41 |
+
|
| 42 |
+
## Links
|
| 43 |
+
|
| 44 |
+
- Code: [github.com/libgs/ffgs](https://github.com/libgs/ffgs)
|
| 45 |
+
- Package: [pypi.org/project/ffgs](https://pypi.org/project/ffgs/)
|
| 46 |
+
- Licenses: the ffgs core is Apache-2.0; vendored model code and all weights keep
|
| 47 |
+
their own (several non-commercial) licenses — see the
|
| 48 |
+
[README](https://github.com/libgs/ffgs#license).
|