nvidia-nlp-finetune-mixtral

Runs Mixtral-8x7B finetuning benchmarks on NVIDIA GPUs and collects throughput metrics.

7|1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/DeepLink-org/DeepEval-Skills --skill nvidia-nlp-finetune-mixtral-deeplink-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nvidia-nlp-finetune-mixtral
Source: https://github.com/DeepLink-org/DeepEval-Skills/tree/main/skills/NVIDIA/nlp/nvidia-nlp-finetune/mixtral
Command: npx skills add https://github.com/DeepLink-org/DeepEval-Skills --skill nvidia-nlp-finetune-mixtral-deeplink-org

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Evaluating Mixtral-8x7B-Instruct-v0.1 finetuning performance on NVIDIA GPUs requires coordinating Docker containers, distributed training with xtuner, log collection, and throughput calculation, which is error-prone when done manually. ## Core Features & Use Cases - Automated Finetune Execution: Launches single-node 8-GPU or multi-node (e.g., 2x8) full finetuning of Mixtral-8x7B using xtuner, DeepSpeed ZeRO-3, and the OpenAssistant Guanaco dataset via the bundled finetune.sh script. - Structured Metric Collection: Parses training logs with calc.py through calc.sh, validates the output as a single finite number, and writes throughput into result.json. - Multi-Host Support: Provides rank-aware distributed launch guidance in references/multi_host.md, including MASTER_ADDR/NODE_RANK injection and rank-suffixed logging. - Use Case: Ask the agent to run a Mixtral full finetune benchmark on one node with 8 NVIDIA GPUs; it starts the container, validates model shards and dataset, runs training, and produces a result.json containing the measured throughput. ## Quick Start Run a Mixtral-8x7B full finetuning performance evaluation on a single node with 8 NVIDIA GPUs and report the training throughput.

Frequently Asked Questions about nvidia-nlp-finetune-mixtral

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I finetune Mixtral-8x7B on NVIDIA GPUs with xtuner?

Run the bundled finetune.sh script inside the provided Docker container with NODE_COUNT and PROC_PER_NODE set. It launches xtuner train with the full finetune config and DeepSpeed ZeRO-3, writing logs to /workspace/logs.

How to measure training throughput from xtuner logs?

Use calc.sh with the rank0 training log path and iteration range, for example calc.sh TRAIN_LOG 5 22. It calls calc.py, validates the output is a single finite number, and writes it as throughput into result.json.

Can I run multi-node Mixtral finetuning across two machines?

Yes, set NNODES=2 with MASTER_ADDR, MASTER_PORT, and NODE_RANK injected per node. Both nodes must start nearly simultaneously with identical model, dataset, and config, and logs use rank suffixes.

What hardware and Docker image are required for Mixtral finetuning?

Each node needs 8 NVIDIA GPUs with host networking, host IPC, and 128g shared memory. The required image is registry.h.pjlab.org.cn/ailab-sys-sys_gpu/nemo:zs-test containing PyTorch and xtuner dependencies.

Why does the Mixtral finetune benchmark fail validation?

Failures occur when model safetensors shards are missing, configs point to host paths instead of container paths, logs contain CUDA OOM or NCCL timeouts, or calc.py output is not a single finite number.