Add model card and metadata

README.md

@@ -1,3 +1,61 @@
----
-license: mit
----
+---
+license: mit
+library_name: transformers
+pipeline_tag: image-text-to-text
+---
+
+# HiVG: Hierarchical SVG Tokenization
+
+[**Project Page**](https://hy-hivg.github.io/) | [**Paper**](https://huggingface.co/papers/2604.05072) | [**GitHub**](https://github.com/ximinng/HiVG)
+
+HiVG is a hierarchical SVG tokenization framework tailored for autoregressive vector graphics generation. It decomposes raw SVG strings into structured *atomic tokens* and further compresses executable command–parameter groups into geometry-constrained *segment tokens*, substantially improving sequence efficiency while preserving syntactic validity.
+
+## Installation
+
+To use this model, install the official implementation from the GitHub repository:
+
+```bash
+git clone https://github.com/ximinng/HiVG.git
+cd HiVG
+pip install -e .
+```
+
+## Quick Start
+
+You can use the provided inference pipeline for both image-to-SVG and text-to-SVG tasks.
+
+```python
+from hivg_infer import HiSVGInferencePipeline
+
+pipeline = HiSVGInferencePipeline(
+    model_path="xingxm/HiVG-3B-Base",
+    coord_range=234,
+    temperature=0.7,
+    top_p=0.9,
+    max_new_tokens=4096,
+)
+
+# Image-to-SVG
+result = pipeline.img2svg("path/to/your_image.png")
+if result["success"]:
+    print(result["svg"])
+
+# Text-to-SVG
+result = pipeline.text2svg("A minimalist black phone icon with an outline style")
+if result["success"]:
+    with open("output.svg", "w") as f:
+        f.write(result["svg"])
+```
+
+## Citation
+
+If you find HiVG useful in your research, please consider citing:
+
+```bibtex
+@article{xing2026hivg,
+    title={Hierarchical SVG Tokenization: Learning Compact Visual Programs for Scalable Vector Graphics Modeling},
+    author={Xing, Ximing and Xue, Ziteng and Li, Zhenxi and Liang, Weicong evangelist, Wang, Linqing and Yang, Zhantao and Hang, Tiankai and Yin, Zijin and Lu, Qinglin and Wang, Chunyu and Yu, Qian},
+    journal={arXiv preprint arXiv:2604.05072},
+    year={2026}
+}
+```