[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MA874FMS84R5YQP32VACKW":3,"skill-same:01M6MA874FMS84R5YQP32VACKW":89},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":40,"linkOnly":41,"markdownContent":42,"markdownBody":43,"frontMatter":44,"refName":51,"commitSha":52,"skillDirectory":53,"forksCount":54,"repositoryHtmlUrl":55,"repositoryHomepageUrl":56,"ownerHtmlUrl":57,"ownerBlogUrl":58,"ownerDescription":59,"updatedAt":60,"install":61,"resources":74},"01M6MA874FMS84R5YQP32VACKW","huggingface-accelerate",null,"Wraps existing PyTorch training scripts with HuggingFace Accelerate (Accelerator class, accelerate config, accelerate launch) so the same code runs on CPU, single GPU, multi-GPU, multi-node, TPU, or Apple MPS. Covers device placement, FP16\u002FBF16\u002FFP8 mixed precision, gradient accumulation, distributed checkpointing, and switching between DDP, DeepSpeed ZeRO, FSDP, and Megatron backends. Use when converting a single-GPU script to multi-GPU, enabling mixed precision, configuring DeepSpeed ZeRO or FSDP, or setting up gradient accumulation. Use when one script must run on different hardware. Not for callback-heavy training loops (use PyTorch Lightning) or multi-node orchestration with hyperparameter tuning (use Ray Train).","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fhuggingface-accelerate\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"HuggingFace","Accelerate","huggingface accelerate","when","orchestration","loops","Unified API","DDP","FSDP","CPU","megatron","switching","apple","up","api","pytorch lightning","Transformers","code","training","pytorch","tpu","2026-11-10 10:12:30",false,"---\nname: huggingface-accelerate\ndescription: Wraps existing PyTorch training scripts with HuggingFace Accelerate (Accelerator class, accelerate config, accelerate launch) so the same code runs on CPU, single GPU, multi-GPU, multi-node, TPU, or Apple MPS. Covers device placement, FP16\u002FBF16\u002FFP8 mixed precision, gradient accumulation, distributed checkpointing, and switching between DDP, DeepSpeed ZeRO, FSDP, and Megatron backends. Use when converting a single-GPU script to multi-GPU, enabling mixed precision, configuring DeepSpeed ZeRO or FSDP, or setting up gradient accumulation. Use when one script must run on different hardware. Not for callback-heavy training loops (use PyTorch Lightning) or multi-node orchestration with hyperparameter tuning (use Ray Train).\nlicense: MIT\nmetadata:\n  version: 1.0.0\n  category: ml-training\n  maintainer: Kalaris Labs\n  tags: Distributed Training, HuggingFace, Accelerate, DeepSpeed, FSDP, Mixed Precision, PyTorch, DDP, Unified API, Simple\n  dependencies: accelerate, torch, transformers\n---\n\n# HuggingFace Accelerate - Unified Distributed Training\n\n## Quick start\n\nAccelerate simplifies distributed training to 4 lines of code.\n\n**Installation**:\n```bash\npip install accelerate\n```\n\n**Convert PyTorch script** (4 lines):\n```python\nimport torch\n+ from accelerate import Accelerator\n\n+ accelerator = Accelerator()\n\n  model = torch.nn.Transformer()\n  optimizer = torch.optim.Adam(model.parameters())\n  dataloader = torch.utils.data.DataLoader(dataset)\n\n+ model, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n\n  for batch in dataloader:\n      optimizer.zero_grad()\n      loss = model(batch)\n-     loss.backward()\n+     accelerator.backward(loss)\n      optimizer.step()\n```\n\n**Run** (single command):\n```bash\naccelerate launch train.py\n```\n\n## Common workflows\n\n### Workflow 1: From single GPU to multi-GPU\n\n**Original script**:\n```python\n# train.py\nimport torch\n\nmodel = torch.nn.Linear(10, 2).to('cuda')\noptimizer = torch.optim.Adam(model.parameters())\ndataloader = torch.utils.data.DataLoader(dataset, batch_size=32)\n\nfor epoch in range(10):\n    for batch in dataloader:\n        batch = batch.to('cuda')\n        optimizer.zero_grad()\n        loss = model(batch).mean()\n        loss.backward()\n        optimizer.step()\n```\n\n**With Accelerate** (4 lines added):\n```python\n# train.py\nimport torch\nfrom accelerate import Accelerator  # +1\n\naccelerator = Accelerator()  # +2\n\nmodel = torch.nn.Linear(10, 2)\noptimizer = torch.optim.Adam(model.parameters())\ndataloader = torch.utils.data.DataLoader(dataset, batch_size=32)\n\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)  # +3\n\nfor epoch in range(10):\n    for batch in dataloader:\n        # No .to('cuda') needed - automatic!\n        optimizer.zero_grad()\n        loss = model(batch).mean()\n        accelerator.backward(loss)  # +4\n        optimizer.step()\n```\n\n**Configure** (interactive):\n```bash\naccelerate config\n```\n\n**Questions**:\n- Which machine? (single\u002Fmulti GPU\u002FTPU\u002FCPU)\n- How many machines? (1)\n- Mixed precision? (no\u002Ffp16\u002Fbf16\u002Ffp8)\n- DeepSpeed? (no\u002Fyes)\n\n**Launch** (works on any setup):\n```bash\n# Single GPU\naccelerate launch train.py\n\n# Multi-GPU (8 GPUs)\naccelerate launch --multi_gpu --num_processes 8 train.py\n\n# Multi-node\naccelerate launch --multi_gpu --num_processes 16 \\\n  --num_machines 2 --machine_rank 0 \\\n  --main_process_ip $MASTER_ADDR \\\n  train.py\n```\n\n### Workflow 2: Mixed precision training\n\n**Enable FP16\u002FBF16**:\n```python\nfrom accelerate import Accelerator\n\n# FP16 (with gradient scaling)\naccelerator = Accelerator(mixed_precision='fp16')\n\n# BF16 (no scaling, more stable)\naccelerator = Accelerator(mixed_precision='bf16')\n\n# FP8 (H100+)\naccelerator = Accelerator(mixed_precision='fp8')\n\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n\n# Everything else is automatic!\nfor batch in dataloader:\n    with accelerator.autocast():  # Optional, done automatically\n        loss = model(batch)\n    accelerator.backward(loss)\n```\n\n### Workflow 3: DeepSpeed ZeRO integration\n\n**Enable DeepSpeed ZeRO-2**:\n```python\nfrom accelerate import Accelerator\n\naccelerator = Accelerator(\n    mixed_precision='bf16',\n    deepspeed_plugin={\n        \"zero_stage\": 2,  # ZeRO-2\n        \"offload_optimizer\": False,\n        \"gradient_accumulation_steps\": 4\n    }\n)\n\n# Same code as before!\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n```\n\n**Or via config**:\n```bash\naccelerate config\n# Select: DeepSpeed → ZeRO-2\n```\n\n**deepspeed_config.json**:\n```json\n{\n    \"fp16\": {\"enabled\": false},\n    \"bf16\": {\"enabled\": true},\n    \"zero_optimization\": {\n        \"stage\": 2,\n        \"offload_optimizer\": {\"device\": \"cpu\"},\n        \"allgather_bucket_size\": 5e8,\n        \"reduce_bucket_size\": 5e8\n    }\n}\n```\n\n**Launch**:\n```bash\naccelerate launch --config_file deepspeed_config.json train.py\n```\n\n### Workflow 4: FSDP (Fully Sharded Data Parallel)\n\n**Enable FSDP**:\n```python\nfrom accelerate import Accelerator, FullyShardedDataParallelPlugin\n\nfsdp_plugin = FullyShardedDataParallelPlugin(\n    sharding_strategy=\"FULL_SHARD\",  # ZeRO-3 equivalent\n    auto_wrap_policy=\"TRANSFORMER_AUTO_WRAP\",\n    cpu_offload=False\n)\n\naccelerator = Accelerator(\n    mixed_precision='bf16',\n    fsdp_plugin=fsdp_plugin\n)\n\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n```\n\n**Or via config**:\n```bash\naccelerate config\n# Select: FSDP → Full Shard → No CPU Offload\n```\n\n### Workflow 5: Gradient accumulation\n\n**Accumulate gradients**:\n```python\nfrom accelerate import Accelerator\n\naccelerator = Accelerator(gradient_accumulation_steps=4)\n\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n\nfor batch in dataloader:\n    with accelerator.accumulate(model):  # Handles accumulation\n        optimizer.zero_grad()\n        loss = model(batch)\n        accelerator.backward(loss)\n        optimizer.step()\n```\n\n**Effective batch size**: `batch_size * num_gpus * gradient_accumulation_steps`\n\n## When to use vs alternatives\n\n**Use Accelerate when**:\n- Want simplest distributed training\n- Need single script for any hardware\n- Use HuggingFace ecosystem\n- Want flexibility (DDP\u002FDeepSpeed\u002FFSDP\u002FMegatron)\n- Need quick prototyping\n\n**Key advantages**:\n- **4 lines**: Minimal code changes\n- **Unified API**: Same code for DDP, DeepSpeed, FSDP, Megatron\n- **Automatic**: Device placement, mixed precision, sharding\n- **Interactive config**: No manual launcher setup\n- **Single launch**: Works everywhere\n\n**Use alternatives instead**:\n- **PyTorch Lightning**: Need callbacks, high-level abstractions\n- **Ray Train**: Multi-node orchestration, hyperparameter tuning\n- **DeepSpeed**: Direct API control, advanced features\n- **Raw DDP**: Maximum control, minimal abstraction\n\n## Common issues\n\n**Issue: Wrong device placement**\n\nDon't manually move to device:\n```python\n# WRONG\nbatch = batch.to('cuda')\n\n# CORRECT\n# Accelerate handles it automatically after prepare()\n```\n\n**Issue: Gradient accumulation not working**\n\nUse context manager:\n```python\n# CORRECT\nwith accelerator.accumulate(model):\n    optimizer.zero_grad()\n    accelerator.backward(loss)\n    optimizer.step()\n```\n\n**Issue: Checkpointing in distributed**\n\nUse accelerator methods:\n```python\n# Save only on main process\nif accelerator.is_main_process:\n    accelerator.save_state('checkpoint\u002F')\n\n# Load on all processes\naccelerator.load_state('checkpoint\u002F')\n```\n\n**Issue: Different results with FSDP**\n\nEnsure same random seed:\n```python\nfrom accelerate.utils import set_seed\nset_seed(42)\n```\n\n## Advanced topics\n\n**Megatron integration**: See [references\u002Fmegatron-integration.md](references\u002Fmegatron-integration.md) for tensor parallelism, pipeline parallelism, and sequence parallelism setup.\n\n**Custom plugins**: See [references\u002Fcustom-plugins.md](references\u002Fcustom-plugins.md) for creating custom distributed plugins and advanced configuration.\n\n**Performance tuning**: See [references\u002Fperformance.md](references\u002Fperformance.md) for profiling, memory optimization, and best practices.\n\n## Hardware requirements\n\n- **CPU**: Works (slow)\n- **Single GPU**: Works\n- **Multi-GPU**: DDP (default), DeepSpeed, or FSDP\n- **Multi-node**: DDP, DeepSpeed, FSDP, Megatron\n- **TPU**: Supported\n- **Apple MPS**: Supported\n\n**Launcher requirements**:\n- **DDP**: `torch.distributed.run` (built-in)\n- **DeepSpeed**: `deepspeed` (pip install deepspeed)\n- **FSDP**: PyTorch 1.12+ (built-in)\n- **Megatron**: Custom setup\n\n## Resources\n\n- Docs: https:\u002F\u002Fhuggingface.co\u002Fdocs\u002Faccelerate\n- GitHub: https:\u002F\u002Fgithub.com\u002Fhuggingface\u002Faccelerate\n- Version: 1.11.0+\n- Tutorial: \"Accelerate your scripts\"\n- Examples: https:\u002F\u002Fgithub.com\u002Fhuggingface\u002Faccelerate\u002Ftree\u002Fmain\u002Fexamples\n- Used by: HuggingFace Transformers, TRL, PEFT, all HF libraries\n\n## Agent operating procedure\n\n1. **Check the environment.** Check GPU type, memory and driver\u002FCUDA versions (`nvidia-smi`), framework versions, and dataset location and size.\n2. **Pin down the inputs.** Confirm formats, identifiers and parameters from the data or the user. Ask rather than guess any value that changes the result.\n3. **Run a small version first.** Do a smoke run: tiny model or subset, few steps, and confirm loss decreases and checkpoints save.\n4. **Execute the full task** using the instructions and references above.\n5. **Validate the result.** Track metrics on held-out data, compare against a baseline, and record seeds, configs and hardware.\n6. **Report.** State what was run (versions, commands, parameters), what was checked, and what is still uncertain.\n\n| If this happens | Do this |\n|---|---|\n| CUDA out-of-memory | Reduce batch size, enable gradient accumulation\u002Fcheckpointing or mixed precision, or shard the model. |\n| Loss is NaN or diverges | Lower the learning rate, check data for invalid values, and enable gradient clipping. |\n| A function, flag or endpoint in these instructions is missing in the installed version | Check the installed version's own documentation (`help()`, `--help`, official docs), adapt, and tell the user. Never invent an API. |\n| A required input, identifier or parameter is ambiguous | Ask the user, or state the assumption explicitly before running. |\n\n**Integrity rules**\n\n- Never fabricate results, parameters, identifiers, citations or statistics. If something cannot be run or verified, say so plainly.\n- Never claim training results without logs; estimate compute cost before launching large jobs.\n- Treat version-specific details here as possibly outdated: confirm them against the official documentation for the installed version.\n- Ask before actions that cost money, consume shared GPUs or cloud quota, touch personal or patient data, or cannot be undone.\n\n## Related skills\n\n- `pytorch-lightning`: Organizes PyTorch training code with the lightning package (PyTorch Lightning): LightningModule, LightningDataModule, Trainer, callbacks su…\n- `pytorch-lightning-distributed`: High-level PyTorch framework with Trainer class, automatic distributed training (DDP\u002FFSDP\u002FDeepSpeed), callbacks system, and minimal boilerp…\n- `deepspeed`: Covers DeepSpeed for distributed deep learning training and I\u002FO: ZeRO optimization stages, pipeline parallelism, FP16\u002FBF16\u002FFP8 training, 1-…\n","# HuggingFace Accelerate - Unified Distributed Training\n\n## Quick start\n\nAccelerate simplifies distributed training to 4 lines of code.\n\n**Installation**:\n```bash\npip install accelerate\n```\n\n**Convert PyTorch script** (4 lines):\n```python\nimport torch\n+ from accelerate import Accelerator\n\n+ accelerator = Accelerator()\n\n  model = torch.nn.Transformer()\n  optimizer = torch.optim.Adam(model.parameters())\n  dataloader = torch.utils.data.DataLoader(dataset)\n\n+ model, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n\n  for batch in dataloader:\n      optimizer.zero_grad()\n      loss = model(batch)\n-     loss.backward()\n+     accelerator.backward(loss)\n      optimizer.step()\n```\n\n**Run** (single command):\n```bash\naccelerate launch train.py\n```\n\n## Common workflows\n\n### Workflow 1: From single GPU to multi-GPU\n\n**Original script**:\n```python\n# train.py\nimport torch\n\nmodel = torch.nn.Linear(10, 2).to('cuda')\noptimizer = torch.optim.Adam(model.parameters())\ndataloader = torch.utils.data.DataLoader(dataset, batch_size=32)\n\nfor epoch in range(10):\n    for batch in dataloader:\n        batch = batch.to('cuda')\n        optimizer.zero_grad()\n        loss = model(batch).mean()\n        loss.backward()\n        optimizer.step()\n```\n\n**With Accelerate** (4 lines added):\n```python\n# train.py\nimport torch\nfrom accelerate import Accelerator  # +1\n\naccelerator = Accelerator()  # +2\n\nmodel = torch.nn.Linear(10, 2)\noptimizer = torch.optim.Adam(model.parameters())\ndataloader = torch.utils.data.DataLoader(dataset, batch_size=32)\n\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)  # +3\n\nfor epoch in range(10):\n    for batch in dataloader:\n        # No .to('cuda') needed - automatic!\n        optimizer.zero_grad()\n        loss = model(batch).mean()\n        accelerator.backward(loss)  # +4\n        optimizer.step()\n```\n\n**Configure** (interactive):\n```bash\naccelerate config\n```\n\n**Questions**:\n- Which machine? (single\u002Fmulti GPU\u002FTPU\u002FCPU)\n- How many machines? (1)\n- Mixed precision? (no\u002Ffp16\u002Fbf16\u002Ffp8)\n- DeepSpeed? (no\u002Fyes)\n\n**Launch** (works on any setup):\n```bash\n# Single GPU\naccelerate launch train.py\n\n# Multi-GPU (8 GPUs)\naccelerate launch --multi_gpu --num_processes 8 train.py\n\n# Multi-node\naccelerate launch --multi_gpu --num_processes 16 \\\n  --num_machines 2 --machine_rank 0 \\\n  --main_process_ip $MASTER_ADDR \\\n  train.py\n```\n\n### Workflow 2: Mixed precision training\n\n**Enable FP16\u002FBF16**:\n```python\nfrom accelerate import Accelerator\n\n# FP16 (with gradient scaling)\naccelerator = Accelerator(mixed_precision='fp16')\n\n# BF16 (no scaling, more stable)\naccelerator = Accelerator(mixed_precision='bf16')\n\n# FP8 (H100+)\naccelerator = Accelerator(mixed_precision='fp8')\n\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n\n# Everything else is automatic!\nfor batch in dataloader:\n    with accelerator.autocast():  # Optional, done automatically\n        loss = model(batch)\n    accelerator.backward(loss)\n```\n\n### Workflow 3: DeepSpeed ZeRO integration\n\n**Enable DeepSpeed ZeRO-2**:\n```python\nfrom accelerate import Accelerator\n\naccelerator = Accelerator(\n    mixed_precision='bf16',\n    deepspeed_plugin={\n        \"zero_stage\": 2,  # ZeRO-2\n        \"offload_optimizer\": False,\n        \"gradient_accumulation_steps\": 4\n    }\n)\n\n# Same code as before!\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n```\n\n**Or via config**:\n```bash\naccelerate config\n# Select: DeepSpeed → ZeRO-2\n```\n\n**deepspeed_config.json**:\n```json\n{\n    \"fp16\": {\"enabled\": false},\n    \"bf16\": {\"enabled\": true},\n    \"zero_optimization\": {\n        \"stage\": 2,\n        \"offload_optimizer\": {\"device\": \"cpu\"},\n        \"allgather_bucket_size\": 5e8,\n        \"reduce_bucket_size\": 5e8\n    }\n}\n```\n\n**Launch**:\n```bash\naccelerate launch --config_file deepspeed_config.json train.py\n```\n\n### Workflow 4: FSDP (Fully Sharded Data Parallel)\n\n**Enable FSDP**:\n```python\nfrom accelerate import Accelerator, FullyShardedDataParallelPlugin\n\nfsdp_plugin = FullyShardedDataParallelPlugin(\n    sharding_strategy=\"FULL_SHARD\",  # ZeRO-3 equivalent\n    auto_wrap_policy=\"TRANSFORMER_AUTO_WRAP\",\n    cpu_offload=False\n)\n\naccelerator = Accelerator(\n    mixed_precision='bf16',\n    fsdp_plugin=fsdp_plugin\n)\n\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n```\n\n**Or via config**:\n```bash\naccelerate config\n# Select: FSDP → Full Shard → No CPU Offload\n```\n\n### Workflow 5: Gradient accumulation\n\n**Accumulate gradients**:\n```python\nfrom accelerate import Accelerator\n\naccelerator = Accelerator(gradient_accumulation_steps=4)\n\nmodel, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)\n\nfor batch in dataloader:\n    with accelerator.accumulate(model):  # Handles accumulation\n        optimizer.zero_grad()\n        loss = model(batch)\n        accelerator.backward(loss)\n        optimizer.step()\n```\n\n**Effective batch size**: `batch_size * num_gpus * gradient_accumulation_steps`\n\n## When to use vs alternatives\n\n**Use Accelerate when**:\n- Want simplest distributed training\n- Need single script for any hardware\n- Use HuggingFace ecosystem\n- Want flexibility (DDP\u002FDeepSpeed\u002FFSDP\u002FMegatron)\n- Need quick prototyping\n\n**Key advantages**:\n- **4 lines**: Minimal code changes\n- **Unified API**: Same code for DDP, DeepSpeed, FSDP, Megatron\n- **Automatic**: Device placement, mixed precision, sharding\n- **Interactive config**: No manual launcher setup\n- **Single launch**: Works everywhere\n\n**Use alternatives instead**:\n- **PyTorch Lightning**: Need callbacks, high-level abstractions\n- **Ray Train**: Multi-node orchestration, hyperparameter tuning\n- **DeepSpeed**: Direct API control, advanced features\n- **Raw DDP**: Maximum control, minimal abstraction\n\n## Common issues\n\n**Issue: Wrong device placement**\n\nDon't manually move to device:\n```python\n# WRONG\nbatch = batch.to('cuda')\n\n# CORRECT\n# Accelerate handles it automatically after prepare()\n```\n\n**Issue: Gradient accumulation not working**\n\nUse context manager:\n```python\n# CORRECT\nwith accelerator.accumulate(model):\n    optimizer.zero_grad()\n    accelerator.backward(loss)\n    optimizer.step()\n```\n\n**Issue: Checkpointing in distributed**\n\nUse accelerator methods:\n```python\n# Save only on main process\nif accelerator.is_main_process:\n    accelerator.save_state('checkpoint\u002F')\n\n# Load on all processes\naccelerator.load_state('checkpoint\u002F')\n```\n\n**Issue: Different results with FSDP**\n\nEnsure same random seed:\n```python\nfrom accelerate.utils import set_seed\nset_seed(42)\n```\n\n## Advanced topics\n\n**Megatron integration**: See [references\u002Fmegatron-integration.md](references\u002Fmegatron-integration.md) for tensor parallelism, pipeline parallelism, and sequence parallelism setup.\n\n**Custom plugins**: See [references\u002Fcustom-plugins.md](references\u002Fcustom-plugins.md) for creating custom distributed plugins and advanced configuration.\n\n**Performance tuning**: See [references\u002Fperformance.md](references\u002Fperformance.md) for profiling, memory optimization, and best practices.\n\n## Hardware requirements\n\n- **CPU**: Works (slow)\n- **Single GPU**: Works\n- **Multi-GPU**: DDP (default), DeepSpeed, or FSDP\n- **Multi-node**: DDP, DeepSpeed, FSDP, Megatron\n- **TPU**: Supported\n- **Apple MPS**: Supported\n\n**Launcher requirements**:\n- **DDP**: `torch.distributed.run` (built-in)\n- **DeepSpeed**: `deepspeed` (pip install deepspeed)\n- **FSDP**: PyTorch 1.12+ (built-in)\n- **Megatron**: Custom setup\n\n## Resources\n\n- Docs: https:\u002F\u002Fhuggingface.co\u002Fdocs\u002Faccelerate\n- GitHub: https:\u002F\u002Fgithub.com\u002Fhuggingface\u002Faccelerate\n- Version: 1.11.0+\n- Tutorial: \"Accelerate your scripts\"\n- Examples: https:\u002F\u002Fgithub.com\u002Fhuggingface\u002Faccelerate\u002Ftree\u002Fmain\u002Fexamples\n- Used by: HuggingFace Transformers, TRL, PEFT, all HF libraries\n\n## Agent operating procedure\n\n1. **Check the environment.** Check GPU type, memory and driver\u002FCUDA versions (`nvidia-smi`), framework versions, and dataset location and size.\n2. **Pin down the inputs.** Confirm formats, identifiers and parameters from the data or the user. Ask rather than guess any value that changes the result.\n3. **Run a small version first.** Do a smoke run: tiny model or subset, few steps, and confirm loss decreases and checkpoints save.\n4. **Execute the full task** using the instructions and references above.\n5. **Validate the result.** Track metrics on held-out data, compare against a baseline, and record seeds, configs and hardware.\n6. **Report.** State what was run (versions, commands, parameters), what was checked, and what is still uncertain.\n\n| If this happens | Do this |\n|---|---|\n| CUDA out-of-memory | Reduce batch size, enable gradient accumulation\u002Fcheckpointing or mixed precision, or shard the model. |\n| Loss is NaN or diverges | Lower the learning rate, check data for invalid values, and enable gradient clipping. |\n| A function, flag or endpoint in these instructions is missing in the installed version | Check the installed version's own documentation (`help()`, `--help`, official docs), adapt, and tell the user. Never invent an API. |\n| A required input, identifier or parameter is ambiguous | Ask the user, or state the assumption explicitly before running. |\n\n**Integrity rules**\n\n- Never fabricate results, parameters, identifiers, citations or statistics. If something cannot be run or verified, say so plainly.\n- Never claim training results without logs; estimate compute cost before launching large jobs.\n- Treat version-specific details here as possibly outdated: confirm them against the official documentation for the installed version.\n- Ask before actions that cost money, consume shared GPUs or cloud quota, touch personal or patient data, or cannot be undone.\n\n## Related skills\n\n- `pytorch-lightning`: Organizes PyTorch training code with the lightning package (PyTorch Lightning): LightningModule, LightningDataModule, Trainer, callbacks su…\n- `pytorch-lightning-distributed`: High-level PyTorch framework with Trainer class, automatic distributed training (DDP\u002FFSDP\u002FDeepSpeed), callbacks system, and minimal boilerp…\n- `deepspeed`: Covers DeepSpeed for distributed deep learning training and I\u002FO: ZeRO optimization stages, pipeline parallelism, FP16\u002FBF16\u002FFP8 training, 1-…\n",{"name":5,"license":15,"metadata":45,"description":7},{"tags":46,"version":47,"category":48,"maintainer":49,"dependencies":50},"Distributed Training, HuggingFace, Accelerate, DeepSpeed, FSDP, Mixed Precision, PyTorch, DDP, Unified API, Simple","1.0.0","ml-training","Kalaris Labs","accelerate, torch, transformers","main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fhuggingface-accelerate",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":62,"prompt":72,"zipAvailable":73},[63,66,69],{"tool":64,"command":65},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill huggingface-accelerate",{"tool":67,"command":68},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill huggingface-accelerate",{"tool":70,"command":71},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill huggingface-accelerate","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fhuggingface-accelerate\u002FSKILL.md",true,[75,81,85],{"path":76,"resourceType":77,"resourceTypeDesc":78,"sizeBytes":79,"sourceHtmlUrl":80},"references\u002Fcustom-plugins.md","REFERENCE","参考文档",11781,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fhuggingface-accelerate\u002Freferences\u002Fcustom-plugins.md",{"path":82,"resourceType":77,"resourceTypeDesc":78,"sizeBytes":83,"sourceHtmlUrl":84},"references\u002Fmegatron-integration.md",11252,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fhuggingface-accelerate\u002Freferences\u002Fmegatron-integration.md",{"path":86,"resourceType":77,"resourceTypeDesc":78,"sizeBytes":87,"sourceHtmlUrl":88},"references\u002Fperformance.md",12569,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fhuggingface-accelerate\u002Freferences\u002Fperformance.md",[90,99,107,115,123,131],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":94,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":98},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":103,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":98},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":111,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":98},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":119,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":98},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":124,"name":125,"nameZh":6,"description":126,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":127,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":98},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":132,"name":133,"nameZh":6,"description":134,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":135,"sourceHtmlUrl":136,"categories":137,"keywords":138,"publishedAt":98},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]