gqk commited on
Commit
e87a9ee
·
verified ·
1 Parent(s): 217303c

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +42 -4
README.md CHANGED
@@ -1,10 +1,48 @@
1
  ---
2
  title: README
3
- emoji: 🏃
4
- colorFrom: purple
5
- colorTo: blue
6
  sdk: static
7
  pinned: false
8
  ---
9
 
10
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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).