Add Sapiens2-1B matting model card

README.md

@@ -0,0 +1,92 @@
+---
+license: other
+license_name: sapiens2-license
+license_link: https://github.com/facebookresearch/sapiens2/blob/main/LICENSE.md
+pipeline_tag: image-segmentation
+library_name: sapiens
+base_model: facebook/sapiens2-pretrain-1b
+tags:
+  - sapiens
+  - sapiens2
+  - human-centric
+  - matting
+---
+
+# Sapiens2-1B-Matting
+
+Per-pixel human image matting with a soft alpha matte and pre-multiplied
+foreground RGB output.
+
+This repository contains the **1B Human Matting** checkpoint, finetuned from the
+[Sapiens2-1B pretrained backbone](https://huggingface.co/facebook/sapiens2-pretrain-1b).
+
+- 📄 **Paper:** [arXiv:2604.21681](https://arxiv.org/pdf/2604.21681)
+- 🌐 **Project Page:** [rawalkhirodkar.github.io/sapiens2](https://rawalkhirodkar.github.io/sapiens2)
+- 💻 **Code:** [github.com/facebookresearch/sapiens2](https://github.com/facebookresearch/sapiens2)
+
+## Model Details
+
+- **Developed by:** Meta
+- **Model type:** Vision Transformer
+- **License:** [Sapiens2 License](https://github.com/facebookresearch/sapiens2/blob/main/LICENSE.md)
+- **Task:** Human image matting
+- **Base model:** [facebook/sapiens2-pretrain-1b](https://huggingface.co/facebook/sapiens2-pretrain-1b)
+- **Format:** safetensors
+- **File:** `sapiens2_1b_matting.safetensors`
+
+## Quick Start
+
+Install the [Sapiens2 repo](https://github.com/facebookresearch/sapiens2) (`pip install -e .`), download the checkpoint, and run the demo:
+
+```bash
+# 1. Download the checkpoint to $SAPIENS_CHECKPOINT_ROOT/matting/
+hf download facebook/sapiens2-matting-1b sapiens2_1b_matting.safetensors \
+    --local-dir ~/sapiens2_host/matting
+
+# 2. Run the demo (edit INPUT, OUTPUT, and MODEL_NAME inside the script)
+cd $SAPIENS_ROOT/sapiens/dense
+./scripts/demo/matting.sh
+```
+
+See the [Human Matting guide](https://github.com/facebookresearch/sapiens2/blob/main/docs/MATTING.md) for details on inputs, outputs, and visualization options.
+
+## Model Card
+
+| Field | Value |
+|-------|-------|
+| Architecture | Sapiens2 ViT backbone + Human Matting head |
+| Backbone parameters | 1.462 B |
+| Backbone FLOPs | 4.715 T |
+| Embedding dim | 1536 |
+| Layers | 40 |
+| Attention heads | 24 |
+| Inference resolution | 1024 × 768 (H × W) |
+| Patch size | 16 |
+
+### Sapiens2-Matting Family
+
+| Model | Params | FLOPs | Embed dim | Layers | Heads |
+|-------|--------|-------|-----------|--------|-------|
+| **Sapiens2-1B** *(this)* | 1.462 B | 4.715 T | 1536 | 40 | 24 |
+
+See the [Sapiens2 Collection](https://huggingface.co/collections/facebook/sapiens2) for all variants and other downstream task checkpoints.
+
+## Intended Use
+
+- Human image matting on human-centric imagery
+- Research on human-centric vision
+
+## License
+
+Released under the [Sapiens2 License](https://github.com/facebookresearch/sapiens2/blob/main/LICENSE.md).
+
+## Citation
+
+```bibtex
+@article{khirodkarsapiens2,
+  title={Sapiens2},
+  author={Khirodkar, Rawal and Wen, He and Martinez, Julieta and Dong, Yuan and Su, Zhaoen and Saito, Shunsuke},
+  journal={arXiv preprint arXiv:2604.21681},
+  year={2026}
+}
+```