VaseVL / README.md
nielsr's picture
nielsr HF Staff
Add model card for VaseVL
83d6da9 verified
|
raw
history blame
3.64 kB
metadata
license: cc-by-nc-nd-4.0
pipeline_tag: image-text-to-text
tags:
  - multimodal
  - vqa
  - cultural-heritage

logo VaseVL: Multimodal Agent for Ancient Greek Pottery

This repository contains the VaseVL model, an SFT-then-RL system designed for robust, expert-level reasoning on ancient Greek pottery. It was presented in the paper VaseVQA: Multimodal Agent and Benchmark for Ancient Greek Pottery.

The code and associated resources for this project are available on GitHub: https://github.com/AIGeeksGroup/VaseVQA.

Introduction

Analyzing cultural-heritage artifacts remains challenging for MLLMs: general models lack domain expertise, and SFT often overfits superficial patterns, yielding brittle reasoning for authentication and historical attribution. This raises the question of how to equip MLLMs with robust, expert-level reasoning for ancient Greek pottery. We present VaseVL, an SFT-then-RL system that turns evaluation into supervision: we construct a taxonomy of question types, probe the SFT model to localize type-specific performance gaps, and optimize with type-conditioned, compositionality-oriented rewards targeting those gaps. We also release VaseVQA, a comprehensive benchmark of 31,773 images designed to probe deep understanding. Experiments show state-of-the-art results on style classification and historical attribution with marked gains in compositional robustness over SFT-only baselines, validating diagnosis-guided, taxonomy-conditioned reward engineering and providing a reusable resource for future research.

Deploy VaseVL Demo UI Locally

To get the full experience of the VaseVL UI, you need to deploy it locally by following the steps below:

  1. Clone the VaseVL repository to your local machine.

    git clone https://github.com/AIGeeksGroup/VaseVL.git
    
  2. Navigate to the ui directory which contains the front-end source code.

    cd ui
    
  3. Install all required Node.js dependencies.

    npm install
    
  4. Build the UI project for production.

    npm run build
    
  5. Start the local server to launch the VaseVL Demo UI.

    npm run start
    

Once the server starts, you can access the VaseVL Demo UI in your browser at http://localhost:1717/projects/1743242682314/playground by default.

License

Our data and model are under an NCND (Non-Commercial, No Derivatives) license, meaning they are for non-commercial use only, and modification of the data for other datasets is not permitted. This corresponds to the CC BY-NC-ND 4.0 license.

Citation

If you use any content of this repository for your work, please cite the following paper:

@article{ge2025vasevqa,
  title={VaseVQA: Multimodal Agent and Benchmark for Ancient Greek Pottery},
  author={Ge, Jinchao and Cheng, Tengfei and Wu, Biao and Zhang, Zeyu and Huang, Shiya and Bishop, Judith and Shepherd, Gillian and Fang, Meng and Chen, Ling and Zhao, Yang},
  journal={arXiv preprint arXiv:2509.17191},
  year={2025}
}