Spectra: A Mechanistic Interpretability Library for Vision-Language Models

Clement Neo, Yongsen Zheng, Kwok-Yan Lam, Luke Ong


Abstract
Vision-Language Models (VLMs) have become increasingly important in AI applications, yet interpretability tools for these models lag behind those available for text-only language models. While libraries like TransformerLens have enabled significant progress in understanding language models, existing tools for VLMs are limited to basic activation probing and saving. We introduce Spectra, a library specifically designed for mechanistic interpretability of VLMs that provides unified abstractions for activation patching, attention pattern analysis, and meta-functions across diverse VLM architectures. Built on HuggingFace’s Transformers, our library handles architecture-specific complexities through per-checkpoint configurations while maintaining a simple, high-level interface. We demonstrate the library’s capabilities by performing interpretability experiments on a counting task, showing how researchers can easily perform experiments that were previously cumbersome to do. The library currently supports Qwen2.5-VL, Qwen3-VL, LLaVA 1.5 and SmolVLM, with a design that facilitates extension to additional architectures. The library can be found at github.com/clemneo/vlm-spectra.
Anthology ID:
2026.acl-demo.78
Volume:
Proceedings of the 64th Annual Meeting of the Association for Computational Linguistics (Volume 3: System Demonstrations)
Month:
July
Year:
2026
Address:
San Diego, California, United States
Editors:
Greg Durrett, Ping Jian
Venue:
ACL
SIG:
Publisher:
Association for Computational Linguistics
Note:
Pages:
794–803
Language:
URL:
https://preview.aclanthology.org/ingest-acl/2026.acl-demo.78/
DOI:
Bibkey:
Cite (ACL):
Clement Neo, Yongsen Zheng, Kwok-Yan Lam, and Luke Ong. 2026. Spectra: A Mechanistic Interpretability Library for Vision-Language Models. In Proceedings of the 64th Annual Meeting of the Association for Computational Linguistics (Volume 3: System Demonstrations), pages 794–803, San Diego, California, United States. Association for Computational Linguistics.
Cite (Informal):
Spectra: A Mechanistic Interpretability Library for Vision-Language Models (Neo et al., ACL 2026)
Copy Citation:
PDF:
https://preview.aclanthology.org/ingest-acl/2026.acl-demo.78.pdf