Add comprehensive README for ViStream model checkpoint

README.md

@@ -1,3 +1,50 @@
----
-license: cc-by-4.0
----
+# ViStream Model Checkpoint
+
+This repository hosts the model checkpoint for **ViStream: Improving Computation Efficiency of Visual Streaming Perception via Law-of-Charge-Conservation Inspired Spiking Neural Network** (CVPR 2025).
+
+## Model Description
+
+ViStream is a novel framework that leverages the Law of Charge Conservation (LoCC) property in ST-BIF neurons and a differential encoding (DiffEncode) scheme to optimize SNN inference for Visual Streaming Perception. The framework achieves significant computational reduction while maintaining accuracy equivalent to its ANN counterpart across diverse VSP tasks including object detection, tracking, and segmentation.
+
+## Repository Contents
+
+- `checkpoint-90.pth` (292MB) - Pre-trained ViStream model checkpoint
+
+## Usage
+
+Download the checkpoint file and place it in your project directory:
+
+```python
+from huggingface_hub import hf_hub_download
+
+# Download the checkpoint
+checkpoint_path = hf_hub_download(
+    repo_id="AndyBlocker/ViStream", 
+    filename="checkpoint-90.pth"
+)
+```
+
+## Full Implementation
+
+The complete ViStream implementation, demo videos, and documentation are available at:
+**🔗 [GitHub Repository](https://github.com/Intelligent-Computing-Research-Group/ViStream)**
+
+## Citation
+
+```bibtex
+@inproceedings{you2025vistream,
+  title={VISTREAM: Improving Computation Efficiency of Visual Streaming Perception via Law-of-Charge-Conservation Inspired Spiking Neural Network},
+  author={You, Kang and Wei, Ziling and Yan, Jing and Zhang, Boning and Guo, Qinghai and Zhang, Yaoyu and He, Zhezhi},
+  booktitle={Proceedings of the Computer Vision and Pattern Recognition Conference},
+  pages={8796--8805},
+  year={2025}
+}
+```
+
+## Paper
+
+📄 **[Read the full paper](https://openaccess.thecvf.com/content/CVPR2025/papers/You_VISTREAM_Improving_Computation_Efficiency_of_Visual_Streaming_Perception_via_Law-of-Charge-Conservation_CVPR_2025_paper.pdf)**
+
+## License
+
+This model is released under CC-BY-4.0 license.