NVFP4 (4-bit) MoE LoRA training is now supported via ScatterMoE (W4A16) and SonicMoE (W4A4), including adapter merge back into a plain NVFP4 checkpoint.
MoE expert quantization support (via quantize_moe_experts: true) greatly reduces VRAM when training MoE models (FSDP2 compat).
Expand older updates
2026/02:
ScatterMoE LoRA support. LoRA fine-tuning directly on MoE expert weights using custom Triton kernels.
Axolotl now has support for SageAttention and GDPO (Generalized DPO).
2026/01:
New integration for EAFT (Entropy-Aware Focal Training), weights loss by entropy of the top-k logit distribution, and Scalable Softmax, improves long context in attention.
2025/09: Axolotl now has text diffusion training. Read more here.
2025/08: QAT has been updated to include NVFP4 support. See PR.
2025/07:
ND Parallelism support has been added into Axolotl. Compose Context Parallelism (CP), Tensor Parallelism (TP), and Fully Sharded Data Parallelism (FSDP) within a single node and across multiple nodes. Check out the blog post for more info.
TiledMLP support for single-GPU to multi-GPU training with DDP, DeepSpeed and FSDP support has been added to support Arctic Long Sequence Training. (ALST). See examples for using ALST with Axolotl!
2025/06: Magistral with mistral-common tokenizer support has been added to Axolotl. See docs to start training your own Magistral models with Axolotl!
2025/05: Quantization Aware Training (QAT) support has been added to Axolotl. Explore the docs to learn more!
2025/04: Llama 4 support has been added in Axolotl. See docs to start training your own Llama 4 models with Axolotl's linearized version!
2025/03: Axolotl has implemented Sequence Parallelism (SP) support. Read the blog and docs to learn how to scale your context length when fine-tuning.
2025/03: (Beta) Fine-tuning Multimodal models is now supported in Axolotl. Check out the docs to fine-tune your own!
2025/02: Axolotl has added LoRA optimizations to reduce memory usage and improve training speed for LoRA and QLoRA in single GPU and multi-GPU training (DDP and DeepSpeed). Jump into the docs to give it a try.
2025/02: Axolotl has added GRPO support. Dive into our blog and GRPO example and have some fun!
2025/01: Axolotl has added Reward Modelling / Process Reward Modelling fine-tuning support. See docs.
✨ Overview
Axolotl is a free and open-source tool designed to streamline post-training and fine-tuning for the latest large language models (LLMs).
Features:
Multiple Model Support: Train various models like GPT-OSS, LLaMA, Mistral, Mixtral, Pythia, and many more models available on the Hugging Face Hub.
Multimodal Training: Fine-tune vision-language models (VLMs) including LLaMA-Vision, Qwen2-VL, Pixtral, LLaVA, SmolVLM2, GLM-4.6V, InternVL 3.5, Gemma 3n, PaddleOCR-VL, Muse Glimmer, and audio models like Voxtral with image, video, and audio support.
Training Methods: Full fine-tuning, LoRA, QLoRA, GPTQ, QAT (int8/int4/FP8/NVFP4/MXFP4), FP8 mixed-precision training, NVFP4/MXFP4 MoE LoRA, Preference Tuning (DPO, IPO, KTO, ORPO), RL (GRPO, GDPO), and Reward Modelling (RM) / Process Reward Modelling (PRM).
Easy Configuration: Re-use a single YAML configuration file across the full fine-tuning pipeline: dataset preprocessing, training, evaluation, quantization, and inference.
Axolotl ships with built-in documentation optimized for AI coding agents (Claude Code, Cursor, Copilot, etc.). These docs are bundled with the pip package, no repo clone needed.
# Show overview and available training methods
axolotl agent-docs
# Topic-specific references
axolotl agent-docs sft # supervised fine-tuning
axolotl agent-docs grpo # GRPO online RL
axolotl agent-docs preference_tuning # DPO, KTO, ORPO, SimPO
axolotl agent-docs reward_modelling # outcome and process reward models
axolotl agent-docs pretraining # continual pretraining
axolotl agent-docs --list # list all topics
# Dump config schema for programmatic use
axolotl config-schema
axolotl config-schema --field adapter
If you're working with the source repo, agent docs are also available at docs/agents/ and the project overview is in AGENTS.md.
Contributions are welcome! Please see our Contributing Guide for details.
📈 Telemetry
Axolotl has opt-out telemetry that helps us understand how the project is being used
and prioritize improvements. We collect basic system information, model types, and
error rates, never personal data or file paths. Telemetry is enabled by default. To
disable it, set AXOLOTL_DO_NOT_TRACK=1. For more details, see our telemetry documentation.
Что это такое?Axolotl — это бесплатный фреймворк с открытым кодом, который упрощает пост-обучение и дообучение больших языковых моделей: вы описываете запуск в одном YAML-конфиге, а он ведёт весь процесс от начала до конца.
Это библиотека Python, которую я импортирую, или отдельная программа, которую я запускаю?Это самостоятельный инструмент для обучения, который запускается на GPU, а не библиотека для написания кода: установите его из PyPI или через Docker, напишите YAML-конфиг и запустите обучение из командной строки.
Как мне запустить своё первое дообучение?Установите через Docker (в README его называют самым надёжным способом, где меньше всего ошибок) или pip, возьмите за основу пример конфига из каталога Examples, укажите свою модель и датасет и следуйте руководству Quick Start.
Какой компьютер мне нужен, чтобы это запустить?Python 3.11 или новее (рекомендуется 3.12), PyTorch 2.11+ и видеокарта NVIDIA (Ampere или новее — для bf16 и Flash Attention) либо AMD.
В чём подвох — есть ли у них хостинг, чтобы всё работало за меня?Нет, всё делается своими руками: никакого хостинга нет, придётся обучать на своём GPU или арендовать его у поддерживаемых облачных провайдеров вроде RunPod, Vast.ai или Modal.
Приложение отправляет куда-то данные, пока я обучаю модель?Да, телеметрия с возможностью отключения включена по умолчанию и отправляет базовую информацию о системе, типы моделей и частоту ошибок — но никогда не личные данные и не пути к файлам. Чтобы её выключить, задайте переменную AXOLOTLDONOTTRACK=1.
Какие модели и способы обучения он поддерживает?Модели с Hugging Face Hub — в README упомянуты GPT-OSS, LLaMA, Mistral, Mixtral и Pythia, а также добавленные в 2026 году Qwen3.5, Gemma 4 и GLM-4.7-Flash. Методы: полное дообучение, LoRA/QLoRA, QAT (int8/int4/FP8/NVFP4), настройка на предпочтения (DPO, IPO, KTO, ORPO), RL (GRPO) и обучение модели наград, а также визуально-языковые и аудио-модели вроде Qwen2-VL и Voxtral.
Мне придётся много писать кода, чтобы настроить запуск?Нет — весь процесс управляется одним YAML-файлом конфигурации: предобработка датасета, обучение, оценка, квантизация и инференс. Обычно вы просто берёте пример конфига и правите настройки, а не пишете код обучения.
Где могут храниться мои датасеты для обучения?Практически где угодно: Axolotl загружает датасеты с локального диска, из Hugging Face Hub или из облачных хранилищ S3, Azure, GCP и OCI.
Что делать, если одной видеокарты для моей модели не хватает?Он масштабируется на несколько машин: обучение на нескольких GPU через FSDP1/FSDP2 или DeepSpeed, запуски на нескольких узлах с Torchrun или Ray, а также приёмы параллелизма вроде sequence и context parallelism для обучения на длинном контексте.