This repository provides the official PyTorch implementation of the following paper:
OPERA: Alleviating Hallucination in Multi-Modal Large Language Models via Over-Trust Penalty and Retrospection-Allocation
Qidong Huang1,2, Xiaoyi Dong2, Pan Zhang2, Bin Wang 2, Conghui He 2, Jiaqi Wang2, Dahua Lin2, Weiming Zhang1, Nenghai Yu1
1University of Science and Technology of China, 2Shanghai AI Laboratory
Hallucination, posed as a pervasive challenge of multimodal large language models (MLLMs), has significantly impeded their real-world usage that demands precise judgment. Existing methods mitigate this issue with either training with specific designed data or inferencing with external knowledge from other sources, incurring inevitable additional costs. In this paper, we present OPERA, a novel MLLM decoding method grounded in an Over-trust Penalty and a Retrospection-Allocation strategy, serving as a nearly free lunch to alleviate the hallucination issue without additional data, knowledge, or training. Our approach begins with an interesting observation that, most hallucinations are closely tied to the knowledge aggregation patterns manifested in the self-attention matrix, i.e., MLLMs tend to generate new tokens by focusing on a few summary tokens, but not all the previous tokens. Such partial overtrust inclination results in the neglecting of image tokens and describes the image content with hallucination. Based on the observation, OPERA introduces a penalty term on the model logits during the beam-search decoding to mitigate the over-trust issue, along with a rollback strategy that retrospects the presence of summary tokens in the previously generated tokens, and re-allocate the token selection if necessary. With extensive experiments, OPERA shows significant hallucination-mitigating performance on different MLLMs and metrics, proving its effectiveness and generality.
The main implementation of OPERA is in transformers-4.29.2/src/transformers/generation/utils.py
.
So it is convenient to use OPERA decoding by just installing our modified transformers
package.
conda env create -f environment.yml
conda activate opera
python -m pip install -e transformers-4.29.2
transformers-4.29.2/src/transformers/generation/utils.py
.transformers.generate
function here.transformers.generate
function here.opera_decoding
function here.After setup the environment, you can directly use OPERA on your own MLLM model by:
# specify the location indexes of some input tokens
START_INDEX_of_IMAGE_TOKENS = <the location index of the first image token>
END_INDEX_of_IMAGE_TOKENS = <the location index of the last image token>
NUM_of_TOKENS_IN_THE_PROMPT = <the total number of tokens in the user prompt (including image tokens)>
key_position = {
"image_start": START_INDEX_of_IMAGE_TOKENS,
"image_end": END_INDEX_of_IMAGE_TOKENS,
"response_start": NUM_of_TOKENS_IN_THE_PROMPT,
}
# add some arguments in the generate function
outputs = MLLM_model.generate(
input_ids=input_ids,
inputs_embeds=inputs_embeds,
attention_mask=attention_mask,
do_sample=False,
num_beams=5,
max_new_tokens=512,
# opera
opera_decoding=True,
key_position=key_position,
scale_factor=50,
threshold=15,
num_attn_candidates=5,
penalty_weights=1,
)
# for a more efficient version, please use the setting below:
outputs = MLLM_model.generate(
input_ids=input_ids,
inputs_embeds=inputs_embeds,
attention_mask=attention_mask,
do_sample=False,
num_beams=5,
max_new_tokens=512,
# opera
opera_decoding=True,
key_position=key_position,
scale_factor=50,
threshold=25,
num_attn_candidates=1,
penalty_weights=1,
)
Please refer to demo.ipynb
here for more details.
The following evaluation requires for MSCOCO 2014 dataset. Please download here and extract it in your data path.
Besides, it needs you to prepare the following checkpoints of 7B base models:
eval_configs/llava-1.5_eval.yaml
.minigpt4/configs/models/blip2_instruct_vicuna7b.yaml
.minigpt4/configs/models/minigpt4_vicuna0.yaml
.eval_configs/minigpt4_eval.yaml
.eval_configs/shikra_eval.yaml
.Argument | Example | Description |
---|---|---|
--model |
llava-1.5 |
Specify the MLLM model, this codebase supports instructblip , minigpt4 , llava-1.5 , shikra . |
--data-path |
/path/to/dataset |
Path to the dataset file or folder, e.g., COCO_2014/val2014/ . |
--pope-type |
random |
Type for POPE evaluation, supports random , popular , adversarial . |
--scale_factor |
50 |
The scale factor to scale up the self-attention weights. Default: 50. |
--threshold |
15 |
The threshold for attending retrospection. Default: 15. |
--num_attn_candidates |
5 |
The number of candidates per beam. Default: 5. |
--penalty_weights |
1 |
The weight of penalty term in decoding. Default: 1. |
python pope_eval.py --model MODEL_NAME --data_path /path/to/COCO --pope-type random --gpu-id GPU_IDs --beam 5 --scale_factor 50 --threshold 15 --num_attn_candidates 5 --penalty_weights 1
Result on Random
split:
Model | Accuracy | Precision | Recall | F1 score | Yes ratio |
---|---|---|---|---|---|
InstructBLIP 7B | 90.3 | 93.8 | 87.0 | 90.3 | 47.8 |
MiniGPT-4 7B | 79.8 | 89.7 | 68.7 | 77.8 | 39.5 |
LLaVA-1.5 7B | 89.4 | 90.4 | 88.8 | 89.6 | 50.6 |
Result on Popular
split:
Model | Accuracy | Precision | Recall | F1 score | Yes ratio |
---|---|---|---|---|---|
InstructBLIP 7B | 83.4 | 81.2 | 87.0 | 84.0 | 53.6 |
MiniGPT-4 7B | 73.6 | 75.9 | 69.0 | 72.3 | 45.4 |
LLaVA-1.5 7B | 86.0 | 84.1 | 88.8 | 86.4 | 52.8 |
Result on Adversarial
split:
Model | Accuracy | Precision | Recall | F1 score | Yes ratio |
---|---|---|---|---|---|
InstructBLIP 7B | 80.7 | 77.3 | 87.0 | 81.9 | 56.3 |
MiniGPT-4 7B | 71.6 | 72.9 | 68.9 | 70.8 | 47.3 |
LLaVA-1.5 7B | 79.1 | 74.4 | 88.8 | 81.0 | 59.7 |
Generate the MLLM's responses and save them in a jsonl file:
python chair_eval.py --model MODEL_NAME --data_path /path/to/COCO --gpu-id GPU_IDs --beam 5 --scale_factor 50 --threshold 15 --num_attn_candidates 5 --penalty_weights 1
Note: Please check out our released results in log/chair_eval_results
for reproduction.
Calculate CHAIR using the generated jsonl file:
python chair.py --cap_file /path/to/jsonl --image_id_key image_id --caption_key caption --coco_path /path/to/COCO/annotations_trainval2014/annotations/ --save_path /path/to/save/jsonl
The GPT-4V evaluation requires you to specify your API key in Line 88 of gpt4v_eval.py
.
python gpt4v_eval.py --model MODEL_NAME --data_path /path/to/COCO --gpu-id GPU_IDs --scale_factor 50 --threshold 15 --num_attn_candidates 5 --penalty_weights 1
This repo is based on the MLLM codebase of LAVIS and MiniGPT-4 and the CHAIR code of Maxlinn. Thanks for their impressive works!
If you find this work useful for your research, please cite our paper:
@inproceedings{huang2024opera,
title={Opera: Alleviating hallucination in multi-modal large language models via over-trust penalty and retrospection-allocation},
author={Huang, Qidong and Dong, Xiaoyi and Zhang, Pan and Wang, Bin and He, Conghui and Wang, Jiaqi and Lin, Dahua and Zhang, Weiming and Yu, Nenghai},
booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},
pages={13418--13427},
year={2024}
}