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