Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

🚀 NeMo AutoModel

📣 News and Discussions

Overview

Nemo AutoModel is a Pytorch DTensor‑native SPMD open-source training library under NVIDIA NeMo Framework, designed to streamline and scale training and finetuning for LLMs and VLMs. Designed for flexibility, reproducibility, and scale, NeMo AutoModel enables both small-scale experiments and massive multi-GPU, multi-node deployments for fast experimentation in research and production environments.

AutoModel Logo

What you can expect:

  • Hackable with a modular design that allows easy integration, customization, and quick research prototypes.
  • Minimal ceremony: YAML-driven recipes; override any field using CLI.
  • High performance and flexibility with custom kernels and DTensor support.
  • Seamless integration with Hugging Face for day-0 model support, ease of use, and wide range of supported models.
  • Efficient resource management using Kubernetes and Slurm, enabling scalable and flexible deployment across configurations.
  • Documentation with step-by-step guides and runnable examples.

⚠️ Note: NeMo AutoModel is under active development. New features, improvements, and documentation updates are released regularly. We are working toward a stable release, so expect the interface to solidify over time. Your feedback and contributions are welcome, and we encourage you to follow along as new updates roll out.

Why PyTorch Distributed and SPMD

  • One program, any scale: The same training script runs on 1 GPU or 1000+ by changing the mesh.
  • PyTorch Distributed native: Partition model/optimizer states with DeviceMesh + placements (Shard, Replicate).
  • SPMD first: Parallelism is configuration. No model rewrites when scaling up or changing strategy.
  • Decoupled concerns: Model code stays pure PyTorch; parallel strategy lives in config.
  • Composability: Mix tensor, sequence, and data parallel by editing placements.
  • Portability: Fewer bespoke abstractions; easier to reason about failure modes and restarts.

Table of Contents

TL;DR: SPMD turns “how to parallelize” into a runtime layout choice, not a code fork.

Feature Roadmap

✅ Available now | 🔜 Coming in 26.02

  • ✅ Advanced Parallelism - PyTorch native FSDP2, TP, CP, and SP for distributed training.

  • ✅ HSDP - Multi-node Hybrid Sharding Data Parallelism based on FSDP2.

  • ✅ Pipeline Support - Torch-native support for pipelining composable with FSDP2 and DTensor (3D Parallelism).

  • ✅ Environment Support - Support for SLURM and interactive training.

  • ✅ Learning Algorithms - SFT (Supervised Fine-Tuning), and PEFT (Parameter Efficient Fine-Tuning).

  • ✅ Pre-training - Support for model pre-training, including DeepSeekV3.

  • ✅ Knowledge Distillation - Support for knowledge distillation with LLMs; VLM support will be added post 25.09.

  • ✅ HuggingFace Integration - Works with dense models (e.g., Qwen, Llama3, etc) and large MoEs (e.g., DSv3).

  • ✅ Sequence Packing - Sequence packing for huge training perf gains.

  • ✅ FP8 and mixed precision - FP8 support with torchao, requires torch.compile-supported models.

  • ✅ DCP - Distributed Checkpoint support with SafeTensors output.

  • ✅ VLM: Support for finetuning VLMs (e.g., Qwen2-VL, Gemma-3-VL). More families to be included in the future.

  • ✅ Extended MoE support - GPT-OSS, Qwen3 (Coder-480B-A35B, etc), Qwen-next.

  • 🔜 Transformers v5 🤗 - Support for transformers v5 🤗 with device-mesh driven parallelism.

  • 🔜 Muon & Dion - Support for Muon and Dion optimizers.

  • 🔜 SonicMoE - Optimized MoE implementation for faster expert computation.

  • 🔜 FP8 MoE - FP8 precision training and inference for MoE models.

  • 🔜 Cudagraph with MoE - CUDA graph support for MoE layers to reduce kernel launch overhead.

  • 🔜 Extended VLM Support - DeepSeek OCR, Qwen3 VL 235B, Kimi-VL, GLM4.5V

  • 🔜 Extended LLM Support - QWENCoder 480B Instruct, MiniMax2.1, and more

  • 🔜 Kubernetes - Multi-node job launch with k8s.

Getting Started

We recommend using uv for reproducible Python environments.

# Setup environment before running any recipes
uv venv

# Choose ONE:
uv sync --frozen  # LLM recipes (default)
# uv sync --frozen --extra vlm  # VLM recipes (fixes: ImportError: qwen_vl_utils is not installed)
# uv sync --frozen --extra cuda  # Optional CUDA deps (e.g., Transformer Engine, bitsandbytes)
# uv sync --frozen --extra all  # Most optional deps (includes `vlm` and `cuda`)
# uv sync --frozen --all-extras  # Everything (includes `fa`, `moe`, etc.)

# One-off runs (examples):
# uv run --extra vlm <command>
# uv run --extra cuda <command>

uv run python -c "import nemo_automodel; print('NeMo AutoModel ready')"

Run a Recipe

All recipes are launched via the automodel CLI (or its short alias am). Each YAML config specifies the recipe class and all training parameters:

# LLM example: multi-GPU fine-tuning with FSDP2
automodel examples/llm_finetune/llama3_2/llama3_2_1b_hellaswag.yaml --nproc-per-node 8

# VLM example: single-GPU fine-tuning (Gemma-3-VL) with LoRA
automodel examples/vlm_finetune/gemma3/gemma3_vl_4b_cord_v2_peft.yaml

# Both commands also work with uv run:
uv run automodel examples/llm_finetune/llama3_2/llama3_2_1b_hellaswag.yaml --nproc-per-node 8

[!TIP] Login-node / CI installs: If you only need to submit jobs (SLURM, k8s, NeMo-Run) and don't need to train locally, install the lightweight CLI package: pip install nemo-automodel[cli]

LLM Pre-training

LLM Pre-training Single Node

We provide an example SFT experiment using the FineWeb dataset with a nano-GPT model, ideal for quick experimentation on a single node.

automodel examples/llm_pretrain/nanogpt_pretrain.yaml --nproc-per-node 8

LLM Supervised Fine-Tuning (SFT)

We provide an example SFT experiment using the SQuAD dataset.

LLM SFT Single Node

The default SFT configuration is set to run on a single GPU. To start the experiment:

automodel examples/llm_finetune/llama3_2/llama3_2_1b_squad.yaml

This fine-tunes the Llama3.2-1B model on the SQuAD dataset using a single GPU.

To use multiple GPUs on a single node, add the --nproc-per-node argument:

automodel examples/llm_finetune/llama3_2/llama3_2_1b_squad.yaml --nproc-per-node 8

LLM SFT Multi Node

To launch on a SLURM cluster, copy the reference sbatch script and adapt it to your cluster:

cp slurm.sub my_cluster.sub
# Edit my_cluster.sub — change CONFIG, #SBATCH directives, container, mounts, etc.
sbatch my_cluster.sub

All cluster-specific settings (nodes, GPUs, partition, container, mounts) live in your sbatch script. NeMo-Run (nemo_run:) sections are also supported -- see our cluster guide for details.

LLM Parameter-Efficient Fine-Tuning (PEFT)

We provide a PEFT example using the HellaSwag dataset.

LLM PEFT Single Node

# Memory-efficient SFT with LoRA
automodel examples/llm_finetune/llama3_2/llama3_2_1b_hellaswag_peft.yaml

# Override any YAML parameter via the command line:
automodel examples/llm_finetune/llama3_2/llama3_2_1b_hellaswag_peft.yaml \
  --step_scheduler.local_batch_size 16

[!NOTE] Launching a multi-node PEFT example uses the same sbatch slurm.sub workflow as the SFT case above.

VLM Supervised Fine-Tuning (SFT)

We provide a VLM SFT example using Qwen2.5-VL for end-to-end fine-tuning on image-text data.

VLM SFT Single Node

# Qwen2.5-VL on 8 GPUs
automodel examples/vlm_finetune/qwen2_5/qwen2_5_vl_3b_rdr.yaml --nproc-per-node 8

VLM Parameter-Efficient Fine-Tuning (PEFT)

We provide a VLM PEFT (LoRA) example for memory-efficient adaptation with Gemma3 VLM.

VLM PEFT Single Node

# Gemma-3-VL PEFT on 8 GPUs
automodel examples/vlm_finetune/gemma3/gemma3_vl_4b_medpix_peft.yaml --nproc-per-node 8

Supported Models

NeMo AutoModel provides native support for a wide range of models available on the Hugging Face Hub, enabling efficient fine-tuning for various domains. Below is a small sample of ready-to-use families (train as-is or swap any compatible 🤗 causal LM), you can specify nearly any LLM/VLM model available on 🤗 hub:

DomainModel FamilyModel IDRecipes
LLMGPT-OSSGPT-OSS-20BSFT
GPT-OSS-120BSFT
LLMDeepSeekDeepSeek-V3Pretrain
LLMMoonlightMoonlight-16B-TEPretrain, SFT
LLMLLaMAmeta-llama/Llama-3.2-1BSFT, PEFT
meta-llama/Llama-3.2-3B-InstructSFT, PEFT
meta-llama/Llama-3.1-8BFP8
meta-llama/Llama-3.3-70B-InstructSFT, PEFT
LLMMistralmistralai/Mistral-7B-v0.1SFT, PEFT, FP8
mistralai/Mistral-Nemo-Base-2407SFT, PEFT, FP8
mistralai/Mixtral-8x7B-Instruct-v0.1SFT, PEFT
LLMQwenQwen/Qwen2.5-7BSFT, PEFT, FP8
Qwen/Qwen3-0.6BSFT, PEFT
Qwen/QwQ-32BSFT, PEFT
LLMGemmagoogle/gemma-3-270mSFT, PEFT
google/gemma-2-9b-itSFT, PEFT, FP8
google/gemma-7bSFT, PEFT
LLMPhimicrosoft/phi-2SFT, PEFT
microsoft/Phi-3-mini-4k-instructSFT, PEFT
microsoft/phi-4SFT, PEFT, FP8
LLMSeedByteDance-Seed/Seed-Coder-8B-InstructSFT, PEFT, FP8
ByteDance-Seed/Seed-OSS-36B-InstructSFT, PEFT
LLMBaichuanbaichuan-inc/Baichuan2-7B-ChatSFT, PEFT, FP8
VLMGemmagoogle/gemma-3-4b-itSFT, PEFT
google/gemma-3n-e4b-itSFT, PEFT

[!NOTE] Check out more LLM and VLM examples. Any causal LM on Hugging Face Hub can be used with the base recipe template, just overwrite --model.pretrained_model_name_or_path <model-id> in the CLI or in the YAML config.

Performance

NeMo AutoModel achieves great training performance on NVIDIA GPUs. Below are highlights from our benchmark results:

Model#GPUsSeq LengthModel TFLOPs/sec/GPUTokens/sec/GPUKernel Optimizations
DeepSeek V3 671B25640962501,002TE + DeepEP
GPT-OSS 20B8409627913,058TE + DeepEP + FlexAttn
Qwen3 MoE 30B8409621211,842TE + DeepEP

For complete benchmark results including configuration details, see the Performance Summary.

🔌 Interoperability

  • NeMo RL: Use AutoModel checkpoints directly as starting points for DPO/RM/GRPO pipelines.
  • Hugging Face: Train any LLM/VLM from 🤗 without format conversion.
  • Megatron Bridge: Optional conversions to/from Megatron formats for specific workflows.

🗂️ Project Structure

NeMo-Automodel/
├── cli/                            # `automodel` / `am` CLI entry-point
│   └── app.py
├── docker/                         # Container build files
├── docs/                           # Documentation and guides
├── examples/
│   ├── benchmark/                  # Benchmarking scripts
│   ├── llm_finetune/              # LLM finetune YAML configs
│   ├── llm_kd/                    # LLM knowledge-distillation configs
│   ├── llm_pretrain/              # LLM pretrain configs
│   ├── llm_seq_cls/               # LLM sequence classification configs
│   ├── vlm_finetune/             # VLM finetune configs
│   └── vlm_generate/             # VLM generation configs
├── nemo_automodel/
│   ├── _transformers/             # HF model integrations
│   ├── components/                # Core library
│   │   ├── _peft/                 # PEFT implementations (LoRA)
│   │   ├── attention/             # Attention implementations
│   │   ├── checkpoint/            # Distributed checkpointing
│   │   ├── config/
│   │   ├── datasets/              # LLM (HellaSwag, etc.) & VLM datasets
│   │   ├── distributed/           # FSDP2, Megatron FSDP, Pipelining, etc.
│   │   ├── launcher/              # Launcher backends (SLURM, k8s, NeMo-Run)
│   │   ├── loggers/               # Loggers
│   │   ├── loss/                  # Optimized loss functions
│   │   ├── models/                # User-defined model examples
│   │   ├── moe/                   # Optimized kernels for MoE models
│   │   ├── optim/                 # Optimizer/LR scheduler components
│   │   ├── quantization/          # FP8
│   │   ├── training/              # Train utils
│   │   └── utils/                 # Misc utils
│   ├── recipes/
│   │   ├── llm/                   # Main LLM train loop
│   │   └── vlm/                   # Main VLM train loop
│   └── shared/
├── tools/                          # Developer tooling
└── tests/                          # Comprehensive test suite

Citation

If you use NeMo AutoModel in your research, please cite it using the following BibTeX entry:

@misc{nemo-automodel,
title = {NeMo AutoModel: DTensor-native SPMD library for scalable and efficient training},
howpublished = {\url{https://github.com/NVIDIA-NeMo/Automodel}},
year = {2025--2026},
note = {GitHub repository},
}

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

NVIDIA NeMo AutoModel is licensed under the Apache License 2.0.

关于 About

Pytorch Distributed native training library for LLMs/VLMs with OOTB Hugging Face support
deepseek-v3-2finetuninggemma3gemma3nglmgpt-osshuggingfacekimi-k2llamallama3llmminimax-m2mistralopenaipytorchqwenqwen3qwen3-nextstepfunvlm

语言 Languages

Python98.0%
Shell1.6%
C++0.3%
Dockerfile0.1%
Makefile0.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
898
Total Commits
峰值: 53次/周
Less
More

核心贡献者 Contributors