Create README.md

README.md

@@ -0,0 +1,141 @@
+---
+license: apache-2.0
+language:
+- en
+base_model:
+- Qwen/Qwen3-VL-8B-Instruct
+pipeline_tag: image-text-to-text
+library_name: transformers
+tags:
+- chart
+- reasoning
+- vision-language
+- multimodal
+- chart-understanding
+- VLM
+- SOTA
+datasets:
+- opendatalab/ChartVerse-SFT-600K
+- opendatalab/ChartVerse-RL-40K
+---
+
+**ChartVerse-8B** is a state-of-the-art Vision Language Model (VLM) achieving top-tier performance on chart reasoning benchmarks, developed as part of the **[opendatalab/ChartVerse](https://huggingface.co/collections/opendatalab/chartverse)** project. For more details about our method, datasets, and full model series, please visit our [GitHub Repository](https://github.com/starriver030515/ChartVerse) and [Project Page](https://chartverse.github.io).
+
+Most notably, **ChartVerse-8B surpasses its teacher model Qwen3-VL-30B-A3B-Thinking (62.9%) and approaches Qwen3-VL-32B-Thinking (67.0%)**, breaking the distillation ceiling and demonstrating that high-quality synthetic data can enable student models to exceed their teachers.
+
+## 🔥 Highlights
+
+- **🏆 SOTA Performance**: 64.1% average score across 6 challenging chart benchmarks
+- **📈 Surpasses Teacher**: Outperforms Qwen3-VL-30B-A3B-Thinking (62.9%) with only 8B parameters
+- **🎯 Approaches 32B**: Rivals Qwen3-VL-32B-Thinking (67.0%) performance
+
+## 📊 Model Performance
+
+### Overall Results
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/chartverse/chartverse.github.io/main/static/images/overall_result.png" width="100%" alt="Overall Performance Comparison">
+</div>
+
+### SFT vs RL Performance
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/chartverse/chartverse.github.io/main/static/images/training_phases.png" width="100%" alt="Training Phases Performance">
+</div>
+
+## 📚 Training Data
+
+### [ChartVerse-SFT-600K](https://huggingface.co/datasets/opendatalab/ChartVerse-SFT-600K)
+- **412K** unique high-complexity charts
+- **603K** QA pairs with **3.9B** tokens of CoT reasoning
+- Rollout Posterior Entropy: **0.44** (highest among all datasets)
+- Truth-anchored answer verification via code execution
+
+### [ChartVerse-RL-40K](https://huggingface.co/datasets/opendatalab/ChartVerse-RL-40K)
+- **40K** highest-difficulty samples
+- Filtered by failure rate: 0 < r(Q) < 1
+- Ensures "hard but solvable" training signal
+
+## 🏋️ Training Details
+
+**Supervised Fine-Tuning (SFT)**:
+- Framework: LLaMA-Factory
+- Dataset: ChartVerse-SFT-600K
+- Learning rate: 1.0 × 10⁻⁵
+- Global batch size: 128
+- Context length: 22,000 tokens
+- Training time: ~1.5 days on 32× A100 GPUs
+
+**Reinforcement Learning (RL)**:
+- Framework: veRL
+- Dataset: ChartVerse-RL-40K
+- Algorithm: GSPO
+- Learning rate: 1.0 × 10⁻⁶
+- Rollout samples: 16 per prompt
+- Training time: ~4 days on 32× A100 GPUs
+
+## 🚀 Quick Start
+
+```python
+from transformers import Qwen3VLForConditionalGeneration, AutoProcessor
+from qwen_vl_utils import process_vision_info
+from PIL import Image
+
+# 1. Load Model
+model_path = "opendatalab/ChartVerse-8B"
+model = Qwen3VLForConditionalGeneration.from_pretrained(
+    model_path, torch_dtype="auto", device_map="auto"
+)
+processor = AutoProcessor.from_pretrained(model_path)
+
+# 2. Prepare Input
+image_path = "path/to/your/chart.png"
+query = "Which region demonstrates the greatest proportional variation in annual revenue compared to its typical revenue level?"
+
+messages = [
+    {
+        "role": "user",
+        "content": [
+            {"type": "image", "image": image_path},
+            {"type": "text", "text": query},
+        ],
+    }
+]
+
+# 3. Inference
+text = processor.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
+image_inputs, video_inputs = process_vision_info(messages)
+inputs = processor(
+    text=[text],
+    images=image_inputs,
+    padding=True,
+    return_tensors="pt",
+).to("cuda")
+generated_ids = model.generate(**inputs, max_new_tokens=16384)
+output_text = processor.batch_decode(
+    generated_ids, skip_special_tokens=True, clean_up_tokenization_spaces=False
+)
+print(output_text[0])
+```
+
+## 📖 Citation
+
+```bibtex
+@article{chartverse2026,
+  title={ChartVerse: Scaling Chart Reasoning via Reliable Programmatic Synthesis from Scratch},
+  author={Anonymous Authors},
+  journal={Anonymous ACL Submission},
+  year={2026}
+}
+```
+
+## 📄 License
+
+This model is released under the Apache 2.0 License.
+
+## 🙏 Acknowledgements
+
+- Base model: [Qwen3-VL-8B-Instruct](https://huggingface.co/Qwen/Qwen3-VL-8B-Instruct)
+- Teacher model: Qwen3-VL-30B-A3B-Thinking
+- Training frameworks: [LLaMA-Factory](https://github.com/hiyouga/LLaMA-Factory), [veRL](https://github.com/volcengine/verl)
+- Evaluation: [VLMEvalKit](https://github.com/open-compass/VLMEvalKit), [Compass-Verifier](https://github.com/open-compass/CompassVerifier)