Enhance model card with metadata, links, and usage example

README.md

@@ -0,0 +1,75 @@
+---
+license: mit
+pipeline_tag: image-text-to-text
+library_name: transformers
+---
+
+# CodePlot-CoT: Mathematical Visual Reasoning by Thinking with Code-Driven Images
+
+<div align="center">
+<a href="https://math-vr.github.io"><img src="https://img.shields.io/badge/Project-Homepage-green" alt="Home"></a>
+<a href="https://huggingface.co/papers/2510.11718"><img src="https://img.shields.io/badge/Paper-red" alt="Paper"></a>
+<a href="https://github.com/HKU-MMLab/Math-VR-CodePlot-CoT"><img src="https://img.shields.io/badge/GitHub-Code-keygen.svg?logo=github&style=flat-square" alt="GitHub"></a>
+</div>
+
+This repository contains the **CodePlot-CoT** model, a core component of the paper [CodePlot-CoT: Mathematical Visual Reasoning by Thinking with Code-Driven Images](https://huggingface.co/papers/2510.11718).
+CodePlot-CoT is an innovative code-driven Chain-of-Thought (CoT) paradigm designed to enable Vision Language Models (VLMs) to "think with images" when solving mathematical problems. Instead of generating pixel-based images directly, the model outputs executable plotting code to represent its "visual thoughts". This code is then executed to render a precise figure, which is reinput to the model as a visual input for subsequent reasoning steps.
+
+The model is built upon the Qwen2.5-VL architecture and is compatible with the `transformers` library.
+
+<div align="center">
+  <img src="https://github.com/HKU-MMLab/Math-VR-CodePlot-CoT/raw/main/figures/teaser.png" width="100%"/>
+</div>
+
+## Sample Usage
+
+### Installation
+To get started with CodePlot-CoT, clone the repository and install the required packages:
+
+```bash
+conda create -n codeplot python==3.10
+conda activate codeplot
+git clone [email protected]:HKU-MMLab/Math-VR-CodePlot-CoT.git
+cd CodePlot-CoT
+pip install -r requirements.txt
+pip install flash_attn==2.7.4.post1
+```
+
+For benchmark evaluation only (additional dependencies):
+```bash
+pip install openai==4.1.1
+pip install datasets==2.0.0
+```
+
+### Model Weights
+Ensure your directory structure for the models looks like this:
+```
+CodePlot-CoT
+├── ckpts
+│   ├── CodePlot-CoT 
+│   ├── MatPlotCode 
+├── ...
+```
+
+### Inference
+You can perform inference using the provided scripts:
+
+```python
+# Convert image to python code with MatPlotCode
+python image_to_code.py
+# Solve math problems with CodePlot-CoT
+python math_infer.py
+```
+
+For more details on evaluation and benchmarks, please refer to the [project homepage](https://math-vr.github.io) and the [GitHub repository](https://github.com/HKU-MMLab/Math-VR-CodePlot-CoT).
+
+## Citation
+If you find this work helpful, please consider citing our paper:
+```bibtex
+@article{duan2025code,
+  title={CodePlot-CoT: Mathematical Visual Reasoning by Thinking with Code-Driven Images},
+  author={Duan, Chengqi and Fang, Rongyao and Wang, Yuqing and Wang, Kun and Huang, Linjiang and Zeng, Xingyu and Li, Hongsheng and Liu, Xihui},
+  journal={arXiv preprint arXiv:2510.11718},
+  year={2025}
+}
+```