Компактная VLM с открытым исходным кодом (около 65 млн параметров), которую можно обучить с нуля примерно за два часа на одной GPU.
2U1/Qwen-VL-Series-Finetune
Скрипты для дообучения семейства vision-language-моделей Qwen-VL (Qwen2-VL, Qwen2.5-VL, Qwen3-VL, Qwen3.5) с помощью Hugging Face и Liger-Kernel.
- Звёзды
- 1,981
- Форки
- 223
- Открытые issues
- 57
- Последний коммит
- 2 месяца назад
Что это?
Проект содержит скрипты для адаптации vision-language-моделей серии Qwen-VL к пользовательским данным. Поддерживаются Qwen2-VL, Qwen2.5-VL, Qwen3-VL и Qwen3.5; для обучения используются Hugging Face Transformers и Liger-Kernel, а не отдельный фреймворк.
Скрипты поддерживают полное дообучение, LoRA и QLoRA, DoRA, DeepSpeed ZeRO, а также раздельную настройку заморозки и разморозки vision tower и слоёв языковой модели. Данные для обучения должны соответствовать формату диалогов LLaVA и могут включать примеры с одним или несколькими изображениями, видео и смешанными модальностями. Помимо supervised fine-tuning, в репозитории есть DPO, GRPO с пользовательскими функциями вознаграждения и обучение классификации с несколькими вариантами функций потерь.
Также в документации описано обучение на цепочках рассуждений для поддерживаемых моделей Qwen3-VL Thinking и Qwen3.5, оценка на основе генерации во время обучения, демо на Gradio для инференса и Docker-образ с готовым окружением.
Ключевые возможности
- 01Полное дообучение, LoRA, QLoRA и DoRA для моделей Qwen-VL.
- 02Обучение на наборах данных с одним или несколькими изображениями, видео и смешанными модальностями в формате LLaVA.
- 03Оптимизация предпочтений (DPO) и GRPO с пользовательскими функциями вознаграждения.
- 04Дообучение для классификации с вариантами cross-entropy или focal loss.
- 05Раздельные скорости обучения и настройки заморозки для модулей обработки изображений и языка.
- 06Поддержка DeepSpeed ZeRO и ускорение с помощью Liger-Kernel.
Сценарии использования
- Адаптация модели Qwen2.5-VL или Qwen3-VL к профильному набору данных для ответов на вопросы по изображениям.
- Обучение модели для понимания видео на роликах с текстовыми описаниями.
- Создание классификатора изображений на основе Qwen-VL.
- Дообучение vision-language-модели в стиле обучения с подкреплением с помощью пользовательских функций вознаграждения.
Быстрый старт
- 1
Установите пакеты Python из requirements.txt
pip install -r requirements.txt -f https://download.pytorch.org/whl/cu128 - 2
Установите qwen-vl-utils
pip install qwen-vl-utils - 3
Установите flash-attn после остальных пакетов
pip install flash-attn --no-build-isolation
Что важно знать
- Настройка обучения рассчитана на Ubuntu с современной видеокартой Nvidia и CUDA 12.8.
- Flash Attention 2 нестабилен в Qwen3.5, поэтому в README рекомендуется отключить его.
- QLoRA нельзя использовать вместе с обучением зрения или Liger-Kernel.
Темы
Частые вопросы
- Что такое Qwen-VL-Series-Finetune?
- Скрипты для дообучения семейства vision-language-моделей Qwen-VL (Qwen2-VL, Qwen2.5-VL, Qwen3-VL, Qwen3.5) с помощью Hugging Face и Liger-Kernel. Проект содержит скрипты для адаптации vision-language-моделей серии Qwen-VL к пользовательским данным. Поддерживаются Qwen2-VL, Qwen2.5-VL, Qwen3-VL и Qwen3.5; для обучения используются Hugging Face Transformers и Liger-Kernel, а не отдельный фреймворк.
- Qwen-VL-Series-Finetune можно использовать бесплатно? Какая у него лицензия?
- Qwen-VL-Series-Finetune распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- Qwen-VL-Series-Finetune всё ещё поддерживается?
- Обновлялся за последние 6 месяцев. Последний коммит в Qwen-VL-Series-Finetune — 9 сент. 2026 г..
- Для чего можно использовать Qwen-VL-Series-Finetune?
- Адаптация модели Qwen2.5-VL или Qwen3-VL к профильному набору данных для ответов на вопросы по изображениям. Обучение модели для понимания видео на роликах с текстовыми описаниями. Создание классификатора изображений на основе Qwen-VL. Дообучение vision-language-модели в стиле обучения с подкреплением с помощью пользовательских функций вознаграждения.
- Как установить Qwen-VL-Series-Finetune?
- Установите пакеты Python из requirements.txt: pip install -r requirements.txt -f https://download.pytorch.org/whl/cu128 Установите qwen-vl-utils: pip install qwen-vl-utils Установите flash-attn после остальных пакетов: pip install flash-attn --no-build-isolation
- Где скачать Qwen-VL-Series-Finetune?
- Исходный код и инструкции по установке — на GitHub: https://github.com/2U1/Qwen-VL-Series-Finetune
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Небольшой учебный проект для запуска инференса vision-language-модели на Apple Silicon с MLX и оценки вариантов ответа по одному изображению.
Превращает экспортированную историю чатов в дообученную LLM, которая пишет в вашем стиле, и запускает её как чат-бота в Telegram, Discord, Slack или WeChat.
Библиотека в стиле Transformers на базе PaddlePaddle для обучения больших языковых и визуально-языковых моделей с API, совместимым с Hugging Face.
Подборка обучающих материалов на китайском языке по развёртыванию, использованию и дообучению открытых LLM и мультимодальных моделей в Linux: полное дообучение, LoRA и P-tuning.
Семейство медицинских мультимодальных больших языковых моделей: HealthGPT-Pro понимает медицинские тексты, 2D-изображения и 3D-объёмы, а HealthGPT объединяет понимание и генерацию.