ms-swift: инфраструктура для настройки LLM и MLLM с PEFT

ms-swift: инфраструктура для настройки LLM и MLLM с PEFT

ms-swift — это инфраструктура для настройки LLM и MLLM с использованием PEFT или полных параметров. Она позволяет эффективно работать с более чем 600 LLM (например, Qwen3.6, Llama4) и 300 MLLM (включая Qwen3-VL, Phi4), что может быть полезно для разработчиков, занимающихся обучением или тонкой настройкой современных моделей.

Проект выделяется между аналогами удобством интеграции с существующими моделями и поддержкой множества архитектур. Благодаря этому, тебе не придется начинать с нуля — можно быстро адаптировать и тестировать различные модели в рамках единой системы. Поддерживаются Python 3.12 и PyTorch версии 2.0 и выше. Для начала работы, следуй инструкциям в документации по установке и использованию.

Имей в виду, что проект на данный момент является стадией разработки, поэтому возможны не все функции или оптимизация, которые ты ожидаешь. Кроме того, актуальный уровень поддержки и сообщество можно проверить через Discord или документацию.

Что такое ms-swift?

ms-swift — это фреймворк для дообучения и развертывания крупных моделей и мультимодальных моделей, предоставленный сообществом ModelScope. Он поддерживает обучение (предварительное обучение, дообучение, согласование с человеком), инференс, оценку, квантизацию и развертывание более 600 текстовых моделей и 400 мультимодальных моделей. В числе поддерживаемых моделей — Qwen3, InternLM3 и множество других.

Для чего нужен ms-swift?

Платформа ms-swift предназначена для упрощения и ускорения процесса обучения и развертывания высококачественных языковых и мультимодальных моделей. Она интегрирует новейшие технологии обучения, включая методы параллелизма Megatron и алгоритмы обучения с подкреплением GRPO. Этот фреймворк предоставляет пользователям удобные инструменты для выполнения различных задач, связанных с обучением и инференсом, тем самым улучшая производительность и ускоряя скорость разработки.

Как установить и запустить?

Установка ms-swift осуществляется с помощью команды pip:

pip install ms-swift -U

Если ты хочешь установить фреймворк из исходников, используй следующие команды:

git clone https://github.com/modelscope/ms-swift.git
cd ms-swift
pip install -e .

Также возможна установка с использованием uv:

uv pip install ms-swift -U --torch-backend=auto

Для работы требуется определённая среда, желательно использовать Python версии 3.12, а также PyTorch версии не ниже 2.0 и другие зависимости. Подробную информацию о необходимых версиях можно найти в README.

Как быстро начать пользоваться?

Чтобы начать обучение модели Qwen3-4B-Instruct-2507 на GPU 3090, можно использовать следующий пример команды:

CUDA_VISIBLE_DEVICES=0 \
swift sft \
    --model Qwen/Qwen3-4B-Instruct-2507 \
    --tuner_type lora \
    --dataset 'AI-ModelScope/alpaca-gpt4-data-zh#500' \
              'AI-ModelScope/alpaca-gpt4-data-en#500' \
              'swift/self-cognition#500' \
    --torch_dtype bfloat16 \
    --num_train_epochs 1 \
    --per_device_train_batch_size 1 \
    --output_dir output

После завершения обучения для инференса можно использовать:

CUDA_VISIBLE_DEVICES=0 \
swift infer \
    --adapters output/vx-xxx/checkpoint-xxx \
    --stream true

Для использования веб-интерфейса просто введи команду:

SWIFT_UI_LANG=en swift web-ui

Ограничения

Хотя ms-swift поддерживает широкий спектр моделей и технологий, существуют некоторые ограничения. Например, для успешной работы потребуется достаточное количество вычислительных ресурсов (GPU), а также корректная настройка окружения и зависимостей. Поддержка различных типов моделей может варьироваться, и некоторые функции могут иметь специфические требования к аппаратному обеспечению или программному обеспечению.

В случае использования нестандартных моделей или датасетов может потребоваться дополнительная настройка и адаптация параметров обучения для успешного завершения процесса.

Радар проекта: 86 из 100 — зрелый и живой проект

ИмпульсТемпЗрелостьСообществоСвежестьСтартПродакшенДовериеДокументацияЭкосистема86
  • Импульс 41 ≈ 8 звёзд в день
  • Темп разработки 100 315 коммитов за 12 недель
  • Зрелость 100 проекту 3 года, больше 100 релизов
  • Сообщество 94 250 участников, 1789 форков
  • Свежесть 97 последний коммит — 6 дней назад
  • Быстрый старт 55 есть: команда установки, сайт/демо, примеры
  • Готовность к продакшену 90 релиз v4.6.0, автосборка, тесты
  • Безопасность и доверие 100 лицензия Apache-2.0, SECURITY.md, организация
  • Документация 100 README 35.9 тыс. знаков, 37 разделов, папка docs
  • Экосистема 82 55 подписчиков на обновления, 19 тем
Как считаем

Только открытые данные GitHub на 07.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.

  • Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
  • Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
  • Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
  • Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
  • Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
  • Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
  • Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
  • Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
  • Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
  • Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.

Открыть на GitHub: modelscope/ms-swift →

Что нового на GitHub — короткие обзоры на русском Новые обзоры приходят в Telegram. Без спама, по делу.
Подписаться

Похожие статьи

Популярные темы на сайте