CoolFace
Modelpublic

SII-Monument-Valley/CiQi-Agent-7B

sourceHugging Facecc-by-nc-4.0updated 29d agoView on Hugging Face
0likes61downloads
Model Card

CiQi-Agent

Github | Model | Dataset | Paper


CiQi-Agent: Aligning Vision, Tools and Aesthetics in Multimodal Agent for Cultural Reasoning on Chinese Porcelains

Accepted to ECCV 2026


๐ŸŽฏ Overview

CiQi-Agent has been accepted to ECCV 2026.

We present CiQi-Agent, a domain-specific multimodal agent for antique Chinese porcelain connoisseurship. The project is designed to combine fine-grained visual perception, tool-augmented reasoning, and cultural-heritage knowledge grounding for explainable porcelain analysis.

CiQi-Agent is built for tool-augmented multimodal reasoning on antique Chinese porcelains. During inference, it can inspect local visual evidence with an image zoom-in tool, retrieve visually similar examples with image retrieval, and access relevant domain knowledge with text retrieval, enabling more grounded and interpretable connoisseurship analysis.

Alongside the model, we release a single Hugging Face dataset repository that contains both the training data and benchmark data:

  • โ€”CiQi-VQA, covering 29,596 porcelain specimens, 51,553 images, and 557,943 VQA pairs
  • โ€”CiQi-Bench, the benchmark portion included in the CiQi-VQA repository, built from 775 porcelain specimens, 878 images, and 5,425 multiple-choice questions

On CiQi-Bench, CiQi-Agent achieves 81.5% average accuracy on multiple-choice evaluation and 66.7% average score on free-form evaluation, outperforming strong open-source and closed-source multimodal baselines.

๐Ÿค– Model

  • โ€”Released as [SII-Monument-Valley/CiQi-Agent-7B](https://huggingface.co/SII-Monument-Valley/CiQi-Agent-7B)
  • โ€”Built on [Qwen2.5-VL-7B-Instruct](https://huggingface.co/Qwen/Qwen2.5-VL-7B-Instruct) with 8.29B parameters
  • โ€”Architecture: Qwen2_5_VLForConditionalGeneration
  • โ€”Inputs: text, one or more images, and optional tool definitions/results
  • โ€”Outputs: text and optional Qwen-style tool calls
  • โ€”Uses tool-augmented reasoning with zoom-in, image retrieval, and text retrieval
  • โ€”Trained with a two-phase supervised fine-tuning + reinforcement learning pipeline
  • โ€”Evaluated on CiQi-Bench with both multiple-choice and free-form protocols
  • โ€”Achieves 81.5% average accuracy on multiple-choice evaluation, exceeding GPT-5 by 5.7 points and the strongest listed open-source baseline GLM-4.5V (72.6%) by 8.9 points
  • โ€”Achieves 66.7% average score on free-form evaluation, exceeding GPT-5 by 18.7 points and Qwen2.5-VL-72B-Instruct by 23.7 points

The released checkpoint is stored in FP32 (approximately 33.2 GB) and can be downcast to BF16 by SGLang while loading. A conservative 4090 profile with a 4K context, an 8192-token KV cache pool, one running request, and CUDA graph disabled completed an OpenAI-compatible chat request using 17,676 MiB. The measurement was collected on a platform-provided 48 GB RTX 4090; it is below a 24 GB memory budget, but a standard 24 GB RTX 4090 was not directly tested. H200-class hardware remains recommended for longer contexts, higher concurrency, and production deployment.

๐Ÿš€ Deployment

Install a recent SGLang release compatible with Qwen2.5-VL. The following command serves the model through an OpenAI-compatible API:

bash
CUDA_VISIBLE_DEVICES=0 python -m sglang.launch_server \
  --model-path SII-Monument-Valley/CiQi-Agent-7B \
  --host 127.0.0.1 \
  --port 18901 \
  --served-model-name ciqi-agent \
  --tp 1 \
  --dp 1 \
  --dtype bfloat16 \
  --context-length 32768 \
  --mem-fraction-static 0.80 \
  --tool-call-parser qwen25 \
  --trust-remote-code \
  --enable-multimodal

For tensor parallel deployment, expose the required GPUs and set --tp to the same GPU count, for example CUDA_VISIBLE_DEVICES=0,1 with --tp 2.

Low-memory RTX 4090 profile

Use this configuration when targeting a 24 GB memory budget:

bash
CUDA_VISIBLE_DEVICES=0 python -m sglang.launch_server \
  --model-path SII-Monument-Valley/CiQi-Agent-7B \
  --host 127.0.0.1 \
  --port 18901 \
  --served-model-name ciqi-agent \
  --tp 1 \
  --dp 1 \
  --dtype bfloat16 \
  --context-length 4096 \
  --max-total-tokens 8192 \
  --max-running-requests 1 \
  --chunked-prefill-size 1024 \
  --mem-fraction-static 0.88 \
  --disable-cuda-graph \
  --tool-call-parser qwen25 \
  --trust-remote-code \
  --enable-multimodal

This profile preserves BF16 model computation; --max-total-tokens limits KV-cache capacity rather than quantizing the model. A single conversation can use up to the configured 4096-token context, including text history, visual tokens, and output. Stop other GPU processes before startup and increase context, concurrency, or the KV-token pool only after checking available memory.

The low-memory configuration reduces context length and concurrency, not the precision of the loaded model. Further weight quantization may reduce memory use, but it can also affect multimodal reasoning and tool-call reliability and has not been validated for this release.

Do not expose the raw model server directly to the public internet. Put it behind TLS, authentication, rate limiting, request-size limits, logging, and key-revocation controls.

OpenAI-compatible chat

After the server becomes ready:

bash
curl http://127.0.0.1:18901/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "ciqi-agent",
    "messages": [
      {"role": "user", "content": "Please introduce yourself in one sentence."}
    ],
    "temperature": 0,
    "max_tokens": 128
  }'

For an image reachable by the model server:

json
{
  "model": "ciqi-agent",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "image_url",
          "image_url": {"url": "https://example.org/object.jpg"}
        },
        {"type": "text", "text": "Describe the object and explain the visual evidence."}
      ]
    }
  ]
}

Tool calling

The model follows the Qwen2.5 tool-calling convention. When serving with SGLang, keep --tool-call-parser qwen25 enabled and pass tools through the OpenAI-compatible tools field. Tool execution remains the responsibility of the client or agent runtime; return each tool result to the model before asking it to continue.

๐Ÿ“Š Model Performance

Multiple-Choice Accuracy (%) on CiQi-Bench

ModelDynastyReignKilnColorMotifShapeNamingAverage
GPT-565.761.479.686.569.383.884.375.8
GPT-4.159.368.371.185.062.281.877.972.2
GPT-4o59.160.468.689.270.184.282.173.4
o357.657.472.282.662.476.876.669.4
Qwen2.5-VL-72B-Instruct57.634.769.286.771.784.180.369.2
GLM-4.5V (106B)58.359.475.882.370.481.880.672.6
InternVL3.5-241B-A28B-Flash57.138.659.582.164.873.968.563.5
Kimi-VL-A3B-Instruct (16B)59.322.848.884.859.877.970.360.5
CiQi-Agent (Ours, 7B)77.670.381.891.475.788.185.281.5

Free-Form Score (%) on CiQi-Bench

ModelDynastyReignKilnColorMotifShapeAverage
GPT-539.432.842.674.435.363.948.0
GPT-4.136.727.229.067.527.660.141.3
GPT-4o26.913.415.153.921.147.629.7
o342.736.644.474.233.162.148.8
Qwen2.5-VL-72B-Instruct29.531.227.775.831.062.643.0
GLM-4.5V (106B)31.014.332.865.431.165.239.9
InternVL3.5-241B-A28B-Flash42.431.636.952.619.641.537.4
Kimi-VL-A3B-Instruct (16B)17.323.716.269.526.561.335.7
CiQi-Agent (Ours, 7B)71.349.169.885.449.775.066.7

๐Ÿ“ฆ Dataset & Benchmark

The [SII-Monument-Valley/CiQi-VQA](https://huggingface.co/datasets/SII-Monument-Valley/CiQi-VQA) repository contains both the CiQi-VQA training data and the CiQi-Bench evaluation data.

๐Ÿ“Š CiQi-VQA Training Data

CiQi-VQA is a large-scale dataset for porcelain-centered multimodal training.

  • โ€”29,596 porcelain specimens
  • โ€”51,553 images
  • โ€”557,943 VQA pairs
  • โ€”38 dynasties
  • โ€”42 reign periods
  • โ€”246 glaze color categories
  • โ€”248 decorative motif categories
  • โ€”158 vessel shape categories

Link: https://huggingface.co/datasets/SII-Monument-Valley/CiQi-VQA

๐Ÿงช CiQi-Bench Evaluation Data

CiQi-Bench is the expert-aligned benchmark portion of the same CiQi-VQA repository for evaluating porcelain connoisseurship ability.

  • โ€”775 porcelain specimens
  • โ€”878 images
  • โ€”5,425 multiple-choice questions
  • โ€”Free-form evaluation with attribute-wise scoring

Repository: https://huggingface.co/datasets/SII-Monument-Valley/CiQi-VQA

๐Ÿ“ˆ Dataset and Benchmark Statistics

Split / ResourcePorcelainsImagesVQA QuestionsMultiple-Choice QuestionsAttributes
CiQi-VQA SFT28,82150,675557,168---dynasty, reign, kiln, color, motif, shape
CiQi-VQA RL subset10,27510,27510,275---dynasty, reign, kiln, color, motif, shape
CiQi-Bench Evaluation7758787755,425dynasty, reign, kiln, color, motif, shape
Total29,59651,553557,9435,425dynasty, reign, kiln, color, motif, shape

Intended Use and Limitations

The model is intended for research and non-commercial cultural-heritage visual question answering, multimodal reasoning, retrieval-augmented generation, and agent/tool-use experiments.

  • โ€”Outputs may be factually incorrect and should not be treated as provenance, authentication, attribution, appraisal, conservation, or legal advice.
  • โ€”The model may inherit biases and limitations from its base model and training data.
  • โ€”Users should verify museum, collection, licensing, and attribution metadata against authoritative sources.
  • โ€”Static repository scans found no plaintext credentials or private deployment paths in this release. This does not prove that a neural model cannot reproduce fragments of its training data; deployments handling sensitive inputs should apply independent memorization and extraction-risk testing.
  • โ€”Do not send confidential images or text to a third-party deployment unless its retention and access policies are acceptable.

๐Ÿ“œ License

  • โ€”Model license: CC BY-NC 4.0
  • โ€”Dataset license: CC BY-NC 4.0

Users are also responsible for complying with the licenses and terms of the base model, source images, and any external retrieval corpus they use.

๐Ÿค Acknowledgement

We thank [Verl](https://github.com/volcengine/verl) for providing an open-source reinforcement learning framework that supports this line of research.

We also thank [DeepEyes](https://github.com/Visual-Agent/DeepEyes) for inspiring and informing our exploration of tool-augmented multimodal reasoning.

๐Ÿ“œ Citation

bibtex
@inproceedings{wang2026ciqiagent,
      title={CiQi-Agent: Aligning Vision, Tools and Aesthetics in Multimodal Agent for Cultural Reasoning on Chinese Porcelains},
      author={Wenhan Wang and Zhixiang Zhou and Zhongtian Ma and Yanzhu Chen and Ziyu Lin and Hao Sheng and Pengfei Liu and Honglin Ma and Wenqi Shao and Qiaosheng Zhang and Yu Qiao},
      booktitle={Proceedings of the European Conference on Computer Vision (ECCV)},
      year={2026},
      eprint={2603.28474},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2603.28474},
}