Downloads · 30 days
31
25% of all-time downloads
PPKQ/HoloGeo
HoloGeo is a image-text-to-text model from PPKQ. Use it for the image-text-to-text task on the model card, and read the license before you ship it in a product. It is set up for transformers. The card lists the license as apache-2.0.
Downloads · 30 days
31
25% of all-time downloads
All-time downloads
124
Public
Parameters
8.3B
16.6 GB on disk
Likes
0
Public
Click a slice to open those files.
.safetensors16.6 GB · 100%
From the Hugging Face model README
🌐 Project Page · 📄 Paper · 💻 Code · 🤗 Dataset
</div>HoloGeo is an open-source vision-language model for robust image geo-localization and geospatial reasoning. It is designed to mitigate landmark bias, where a model over-relies on a salient building, statue, text sign, cultural symbol, or other prominent cue while overlooking complementary evidence from the surrounding environment.
Instead of mapping one salient landmark directly to a location, HoloGeo analyzes multiple image regions and integrates evidence from architecture, vegetation, terrain, climate, infrastructure, text, and cultural context before predicting a country and city.
HoloGeo is introduced in HoloGeo: Mitigating Landmark Bias in Geo-localization via Evidence-Driven Reasoning, accepted at ACM Multimedia 2026. It is trained with BF-30K, which contains structured multi-evidence reasoning chains, and evaluated with LandmarkBias-3K, a diagnostic benchmark for misleading-landmark scenarios.
<Analyze>-<Think>-<Answer> structure.| Item | Description |
|---|---|
| Base model | Qwen/Qwen2.5-VL-7B-Instruct |
| Model type | Vision-language model for image-to-text generation |
| Training | LoRA supervised fine-tuning followed by GRPO reinforcement learning |
| Training data | BF-30K |
| Output | Structured visual analysis, geographic reasoning, country, and city |
| Precision | BF16 |
The released checkpoint contains the merged model weights. The LoRA adapter from the reinforcement-learning checkpoint has been merged into the base model, so the model can be loaded directly with Transformers.
from transformers import AutoProcessor, Qwen2_5_VLForConditionalGeneration
model_id = "PPKQ/HoloGeo"
model = Qwen2_5_VLForConditionalGeneration.from_pretrained(
model_id,
torch_dtype="auto",
device_map="auto",
)
processor = AutoProcessor.from_pretrained(model_id)
HoloGeo uses a two-stage training strategy built on Qwen2.5-VL-7B-Instruct:
Training code and example launch scripts are available in the HoloGeo GitHub repository.
Predictions are evaluated by the geographic distance between the predicted and ground-truth coordinates:
| Granularity | Distance threshold |
|---|---|
| City | 25 km |
| Region | 200 km |
| Country | 750 km |
The accompanying HoloGeo Dataset provides:
The dataset has its own license and usage terms. The model's Apache 2.0 license does not override the licenses, copyrights, or terms associated with dataset annotations or upstream images.
HoloGeo is intended for research on image geo-localization, multimodal geographic reasoning, landmark bias, model robustness, and related evaluation methods.
Image geo-localization can create privacy, surveillance, and spatial-security risks. Do not use HoloGeo for unlawful tracking, privacy infringement, identifying private individuals, evading safety measures, criminal activity, or other harmful purposes.
If you use HoloGeo, LandmarkBias-3K, or BF-30K in your research, please cite:
@inproceedings{zhou2026hologeo,
title = {HoloGeo: Mitigating Landmark Bias in Geo-localization via Evidence-Driven Reasoning},
author = {Zhou, Pengcheng and Liu, Xuanyu and Yin, Yanchen and Li, Bobo and Wu, Shengqiong and Lee, Mong-Li and Hsu, Wynne},
booktitle = {Proceedings of the 34th ACM International Conference on Multimedia},
year = {2026}
}
HoloGeo builds upon Qwen2.5-VL and uses or draws on resources and tools including MP-16, Google Landmarks Dataset v2, GroundingDINO, InternVL3, DeepSpeed, vLLM, and ModelScope Swift. We thank their authors and open-source communities.