README.md · StarCycle/llava-siglip-internlm2-1

metadata

license: apache-2.0
tags:
  - llava
datasets:
  - liuhaotian/LLaVA-Pretrain
  - liuhaotian/LLaVA-Instruct-150K
pipeline_tag: image-text-to-text

Model

llava-siglip-internlm2-1_8b-pretrain-v1 is a LLaVA checkpoint finetuned from internlm2-1_8b and siglip-so400m-patch14-384 with LLaVA-Pretrain and LLaVA-Instruct-150K by Xtuner. The pretraining phase took 5.5 hours on 4 Nvidia GTX 4090 GPU (see this intermediate checkpoint). The finetuning phase took 16 hours on 4 Nvidia GTX 4090 GPU.

The total size of the model is around 2.2B, which is suitable for embedded applications like robotics. This model performs better than llava-siglip-internlm2-1_8b-v1 because I use the base LLM, instead of the SFT version.

I have not carefully tune the hyperparameters during training. If you have any idea to improve it, please open an issue or just send an email to [email protected]. You are welcomed!

Example

Explain this photo in English and Chinese:

Results

Model	MMBench Test (EN)	MMBench Dev (EN)	MMBench Test (CN)	MMBench Dev (CN)	CCBench Dev
LLaVA-v1.5-7B	67.7	69.2	61.0	59.7	28.4
LLaVA-InternLM-7B	69.0	68.5	66.7	63.8	37.3
LLaVA-InternLM2-7B	73.3	74.6	71.7	72.0	42.5
Bunny-3B	69.2	68.6	-	-	-
MiniCPM-V	64.1	67.9	62.6	65.3	41.4
llava-clip-internlm2-1_8b-v1	63.3	63.1	63.6	61.7	35.3
llava-siglip-internlm2-1_8b-v1	65.7	63.5	64.5	62.9	36.3
llava-siglip-internlm2-1_8b-v2	66.6	67.1	64.5	64.1	37.3

MMBench Test EN:

MMBench Test CN:

Installation

# We need the newest version so clone from github
git clone https://github.com/huggingface/transformers/
git clone https://github.com/huggingface/peft
git clone https://github.com/InternLM/xtuner

Now please replace the files in transformers and xtuner with the source code files in modified_transformers and modified_xtuner.

cp -r ./modified_transformers ./transformers
cp -r ./modified_xtuner ./xtuner

Then run

pip install -e ./transformers
pip install -e ./peft
pip install -e ./xtuner[deepspeed]
apt install git-lfs

Chat

xtuner chat internlm/internlm2-1_8b \
--visual-encoder google/siglip-so400m-patch14-384 \
--llava StarCycle/llava-siglip-internlm2-1_8b-v2 \
--prompt-template internlm2_chat \
--image $IMAGE_PATH

Common Errors

command error: 'libGL.so.1: cannot open shared object file: No such file or directory'!

You can solve it by

# For Ubuntu
sudo apt-get update
sudo apt-get install libgl1-mesa-glx

# For CentOS and Fedora
sudo yum install mesa-libGL

Error: mkl-service + Intel(R) MKL: MKL_THREADING_LAYER=INTEL is incompatible with libgomp.so.1 library.
        Try to import numpy first or set the threading layer accordingly. Set MKL_SERVICE_FORCE_INTEL to force it.

You can solve it by reinstall numpy.

ImportError: 
InternLM2Converter requires the protobuf library but it was not found in your environment. Checkout the instructions on the

You just need

pip install protobuf

To use tensorboard to visualize the training loss curve:

pip install future tensorboard

If your training process is killed during data preprocessing, you can modify the map_num_proc in xtuner/xtuner/dataset /huggingface.py

def process(dataset,
            do_dataset_tokenization=True,
            tokenizer=None,
            max_length=None,
            dataset_map_fn=None,
            template_map_fn=None,
            max_dataset_length=None,
            split='train',
            remove_unused_columns=False,
            rename_maps=[],
            shuffle_before_pack=True,
            pack_to_max_length=True,
            use_varlen_attn=False,
            input_ids_with_output=True,
            with_image_token=False,
            map_num_proc=32): # modify it to a smaller number, e.g., 4

If you fail to load the model, check whether you installed git-lfs and actually downloaded the model file.

Data prepration

File structure

# . means the llava-dinov2-internlm2-7b-v1 folder you clone
./data/llava_data
├── LLaVA-Pretrain
│   ├── blip_laion_cc_sbu_558k.json
│   ├── blip_laion_cc_sbu_558k_meta.json
│   └── images
├── LLaVA-Instruct-150K
│   └── llava_v1_5_mix665k.json
└── llava_images
    ├── coco
    │   └── train2017
    ├── gqa
    │   └── images
    ├── ocr_vqa
    │   └── images
    ├── textvqa
    │   └── train_images
    └── vg
        ├── VG_100K
        └── VG_100K_2

Pretrain Data

LLaVA-Pretrain

# Make sure you have git-lfs installed (https://git-lfs.com)
git lfs install
git clone https://huggingface.co/datasets/liuhaotian/LLaVA-Pretrain --depth=1

Finetune Data

3.1 Text data

LLaVA-Instruct-150K

  ```shell
  # Make sure you have git-lfs installed (https://git-lfs.com)
  git lfs install
  git clone https://huggingface.co/datasets/liuhaotian/LLaVA-Instruct-150K --depth=1
  ```

3.2 Image data

3.2.1 COCO (coco): train2017

3.2.2 GQA (gqa): images

3.2.3 OCR-VQA (ocr_vqa): download script

  ⚠️⚠️⚠️ Modify the name of OCR-VQA's images to keep the extension as `.jpg`!

     ```shell
     #!/bin/bash
     ocr_vqa_path="<your-directory-path>"

     find "$target_dir" -type f | while read file; do
         extension="${file##*.}"
         if [ "$extension" != "jpg" ]
         then
             cp -- "$file" "${file%.*}.jpg"
         fi
     done
     ```

3.2.4 TextVQA (textvqa): train_val_images

3.2.5 VisualGenome (VG): part1, part2

Cheers! Now train your own model!

Alignment module pretraining

# single GPU
xtuner train ./pretrain.py --deepspeed deepspeed_zero2

# multiple GPU
NPROC_PER_NODE=4 xtuner train ./pretrain.py --deepspeed deepspeed_zero2

Remember to change the batch size and gradient accumulation parameters to fit your hardware. So your GPU_num * batch_size * gradient_accumulation is roughly equal to mine to reproduce the result.

The checkpoint and tensorboard logs are saved by default in ./work_dirs/. I only train it for 1 epoch to be same as the original LLaVA paper. Some researches also report that training for multiple epochs will make the model overfit the training dataset and perform worse in other domains.

This is my loss curve for llava-siglip-internlm2-1_8b-pretrain-v2:

And the learning rate curve:

Instruction following fine-tuning

NPROC_PER_NODE=4 xtuner train ./finetune.py --deepspeed deepspeed_zero2

Here is my loss curve (the curve fluctuates strongly because the batch size is small, and I only record batch loss instead of epoch loss):

And the learning rate curve:

Transfer the checkpoints to Huggingface safetensor format

xtuner convert pth_to_hf ./finetune.py ./work_dirs/iter_xxx.pth ./my_lora_and_projector

The adapter still need to be used with the internlm/internlm2-1_8b and the vision encoder. I have not tried to merge them yet but it is possible with Xtuner, see this tutorial.

MMBench Evaluation

You can first download the MMBench data:

wget https://opencompass.openxlab.space/utils/VLMEval/MMBench_DEV_EN.tsv
wget https://opencompass.openxlab.space/utils/VLMEval/MMBench_TEST_EN.tsv
wget https://opencompass.openxlab.space/utils/VLMEval/MMBench_DEV_CN.tsv
wget https://opencompass.openxlab.space/utils/VLMEval/MMBench_TEST_CN.tsv
wget https://opencompass.openxlab.space/utils/VLMEval/CCBench.tsv

Then run:

NPROC_PER_NODE=8 xtuner mmbench internlm/internlm2-1_8b \
--visual-encoder google/siglip-so400m-patch14-384 \
--llava ./my_lora_and_projector \
--prompt-template internlm2_chat \
--data-path $MMBENCH_DATA_PATH \
--work-dir $RESULT_PATH

You can also use VLMEvalKit to evaluate it on other benckmarks.

Deployment

Xtuner team is developing HF chatbot (based on Huggingface transformers) and LMDeploy chatbot (based on TurboMind). I am waiting for their final version of API.