← Ко всем open source проектам

LLaMA-Factory

hiyouga/LlamaFactory

LLaMA-Factory — Python-инструмент для настройки и обучения LLM/VLM с CLI, веб-интерфейсом и поддержкой популярных моделей.

Форки 8,820
Автор hiyouga
Язык Python
Лицензия Apache-2.0
Обновлено 2026-06-11

Что это такое

LLaMA-Factory — инструмент для настройки и дообучения больших языковых и мультимодальных моделей. Он нужен тем, кто хочет не писать весь цепочку обучения с нуля, а использовать готовую оболочку вокруг популярных моделей, датасетов и методов вроде LoRA/QLoRA.

Репозиторий hiyouga/LlamaFactory существует на GitHub с 2023 года. Основной язык — Python, лицензия Apache-2.0, документация — llamafactory.readthedocs.io. Проект связан с LLaMA, Qwen, DeepSeek, Gemma, PEFT, RLHF, quantization и Transformers.

Что внутри

Внутри — CLI, веб-интерфейс LLaMA Board на Gradio, конфигурации обучения, поддержка множества моделей, датасеты, документация по установке, логированию и развертыванию. Важная идея — унифицировать повторяющиеся шаги дообучения.

Форма конфигурации обучения

Фрагмент показывает типичную структуру: модель, датасет, метод адаптации и параметры запуска. Это пример формы, а не готовая рекомендация для конкретной модели.

Язык: JSON
{
  "model_name_or_path": "Qwen/Qwen2.5-7B-Instruct",
  "dataset": "company_qa",
  "finetuning_type": "lora",
  "learning_rate": 0.0001,
  "num_train_epochs": 3
}

Где он полезен

Проект полезен исследователям, ML-инженерам и командам, которые экспериментируют с инструкционным дообучением, адаптацией модели под домен, сравнением методов и подготовкой прототипов. Он снижает порог входа в область, где иначе много однотипной инфраструктуры.

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

Проект ценен тем, что собирает вокруг одной команды много повторяющихся действий: выбор модели, подготовку набора данных, метод адаптации, параметры обучения, оценку и экспорт результата. Это не отменяет понимания машинного обучения, но уменьшает количество ручной обвязки.

LLaMA-Factory особенно полезна на этапе экспериментов: можно сравнить методы адаптации, проверить несколько моделей и быстрее понять, есть ли вообще выигрыш от дообучения. В зрелом продукте к этому добавляются контроль данных, воспроизводимость запусков, хранение артефактов и отдельная проверка качества.

Детали проекта

LLaMA-Factory закрывает боль, которая появляется после первых экспериментов с LLM: одной модели “из коробки” часто мало, но ручная настройка обучения быстро превращается в набор скриптов, параметров, форматов данных и несовместимых примеров.

Проект собирает вокруг себя популярные семейства моделей и методы адаптации. LoRA и QLoRA полезны тем, что позволяют менять поведение модели меньшей ценой, чем полное обучение всех весов. Но метод не заменяет качественный набор данных и внятную задачу.

Веб-интерфейс LLaMA Board снижает порог входа для эксперимента, а CLI удобен для повторяемых запусков. Такое сочетание важно: исследователь может быстро попробовать параметры вручную, а инженер затем перенести удачную конфигурацию в автоматический процесс.

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

Проект полезен как ускоритель экспериментов, но зрелая система вокруг модели все равно шире: хранение запусков, сравнение метрик, управление артефактами, стоимость вычислений, безопасность данных и решение, где модель можно применять юридически и этически.

Сильные стороны и ограничения

Сильная сторона LLaMA-Factory — ширина поддержки моделей и методов. Для эксперимента можно быстрее перейти от идеи к запуску и сравнить несколько подходов.

Ограничение — риск иллюзии простоты. Удобный интерфейс не гарантирует хорошую модель. Качество зависит от данных, постановки задачи, оценки и ограничений использования исходной модели.