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).