Improve model card with metadata, links, and usage

README.md

@@ -1,3 +1,48 @@
----
-license: mit
----
+---
+license: mit
+pipeline_tag: image-segmentation
+tags:
+- motion-segmentation
+- 4d-geometry
+---
+
+# GeoMotion: Rethinking Motion Segmentation via Latent 4D Geometry
+
+GeoMotion is a fully learning-based motion segmentation framework that directly infers dynamic masks from latent 4D geometry. It combines 4D geometric priors from a pretrained reconstruction model ($\pi^3$) with local pixel-level motion from optical flow, enabling the disentanglement of object motion from camera motion in a single feed-forward pass.
+
+- **Paper:** [GeoMotion: Rethinking Motion Segmentation via Latent 4D Geometry](https://huggingface.co/papers/2602.21810)
+- **GitHub Repository:** [zjutcvg/GeoMotion](https://github.com/zjutcvg/GeoMotion)
+
+## Introduction
+
+Motion segmentation in dynamic scenes is challenging because traditional methods rely on noisy camera pose estimation and point correspondences. GeoMotion bypasses explicit correspondence estimation, learning instead to implicitly disentangle object and camera motion via attention mechanisms. Supported by recent advances in 4D scene geometry reconstruction, the proposed method leverages reliable camera poses and rich spatial-temporal priors to achieve state-of-the-art performance with high efficiency.
+
+## Sample Usage
+
+To perform motion segmentation on a single sequence, you can use the provided inference script. Ensure you have the environment set up and the required checkpoints downloaded as described in the [official repository](https://github.com/zjutcvg/GeoMotion).
+
+```bash
+python motion_seg_inference.py \
+  --model_path checkpoint/best_model.pth \
+  --pi3_model_path checkpoint/model.safetensors \
+  --input_dir data/test/<sequence_name> \
+  --output_dir output/single \
+  --sequence_length 32 \
+  --threshold 0.5
+```
+
+## Citation
+
+If you find GeoMotion useful for your research, please cite the following:
+
+```bibtex
+@misc{he2026geomotion,
+      title={GeoMotion: Rethinking Motion Segmentation via Latent 4D Geometry}, 
+      author={Xiankang He and Peile Lin and Ying Cui and Dongyan Guo and Chunhua Shen and Xiaoqin Zhang},
+      year={2026},
+      eprint={2602.21810},
+      archivePrefix={arXiv},
+      primaryClass={cs.CV},
+      url={https://arxiv.org/abs/2602.21810}, 
+}
+```