madgrad
MADGRAD 是一款专为深度学习设计的随机优化算法,旨在解决传统优化器在收敛速度与泛化能力之间难以兼顾的痛点。它巧妙融合了动量机制、自适应调整及双重平均梯度技术,既拥有 SGD(随机梯度下降)出色的泛化性能,又具备媲美甚至超越 Adam 的快速收敛速度。
该工具特别适合从事计算机视觉与自然语言处理研究的开发者及科研人员。无论是训练图像分类模型、图像生成任务,还是构建 Transformer 等大规模语言模型,MADGRAD 均能表现优异。其独特亮点在于提供了标准版与镜像下降版(Mirror MADGRAD)两种实现:前者适用于需要强泛化能力的场景,后者则在大规模数据集训练中表现更为卓越,且无需像标准版那样大幅调整权重衰减参数。
使用上,MADGRAD 对 PyTorch 用户极为友好,支持通过 pip 直接安装或作为单文件嵌入项目,也可无缝集成至 FairSeq 框架。不过需要注意的是,由于算法特性,使用者通常需要进行学习率搜索以找到最佳参数,部分场景下还需配合梯度裁剪使用。作为一款开源成果,MADGRAD 为追求高效训练与优异测试性能的团队提供了一个强有力的新选择。
使用场景
某计算机视觉团队正在基于 ResNet-50 架构训练一个大规模图像分类模型,目标是快速收敛并在 ImageNet 数据集上获得最高的测试集准确率。
没有 madgrad 时
- 优化器选择两难:使用 SGD 虽然泛化性能好但收敛缓慢,耗时极长;改用 Adam 虽收敛快,却在最终测试精度上往往不如 SGD,陷入“速度”与“精度”的权衡困境。
- 调参成本高昂:为了平衡两者,工程师需要花费数天时间反复调整学习率调度策略和动量参数,尝试寻找所谓的“最佳平衡点”。
- 训练资源浪费:由于收敛速度慢或需要更多 epoch 才能达到理想精度,导致 GPU 集群长时间高负荷运转,显著增加了算力成本和碳排放。
- 特定任务表现不佳:在某些对自适应方法不友好的视觉任务中,传统自适应优化器容易陷入局部最优,导致模型性能天花板较低。
使用 madgrad 后
- 兼得速度与精度:madgrad 成功结合了 SGD 的优异泛化能力和 Adam 的快速收敛特性,在更少的训练步数内达到了甚至超越了 SGD 的最终精度。
- 简化调参流程:只需进行一次完整的学习率扫描(如设定为 0.001),即可快速锁定最优参数,无需在复杂的超参数组合中盲目试错。
- 显著提升效率:模型收敛速度大幅加快,缩短了整体训练周期,使团队能在相同时间内迭代更多实验方案,加速产品落地。
- 广泛适用性强:无论是标准的图像分类还是复杂的图像到图像任务,madgrad 均表现出稳定的优越性,尤其在大型 Transformer 训练中配合 MirrorMADGRAD 版本效果更佳。
madgrad 通过打破传统优化器的性能妥协,让深度学习训练同时实现了“跑得快”和“算得准”。
运行环境要求
未说明
未说明

快速开始
MADGRAD 优化方法
一种用于随机优化的动量化、自适应、对偶平均梯度方法
文档可在 https://madgrad.readthedocs.io/en/latest/ 获取。
pip install madgrad
立即试用!这是一种兼具两全其美的优化器,它拥有与 SGD 相当的泛化性能,且收敛速度至少不逊于 Adam,通常甚至更快。我们提供了一个可直接替换 torch.optim 的实现 madgrad.MADGRAD,以及一个封装在 FairSeq 中的实例。对于 FairSeq,只需在项目文件中的任意位置导入 madgrad,并使用命令行选项 --optimizer madgrad,同时配合 --weight-decay、--momentum,以及可选的 --madgrad_eps。
如果您不想通过 pip 安装,也可以将包含该优化器的 madgrad.py 文件直接放入任何 PyTorch 项目中。如果您使用 FairSeq,则还需要配套的 fairseq_madgrad.py 文件。
注意事项:
- 您可能需要使用比平时更低的权重衰减值,很多时候设为 0 即可。
- 建议进行全面的学习率搜索,因为最佳学习率会与 SGD 或 Adam 不同。我们发现的最佳学习率包括:CIFAR10 数据集上 152 层 PreActResNet 的 2.5e-4,ImageNet 上 ResNet-50 的 0.001,使用
transformer_iwslt_de_en模型的 IWSLT14 数据集上的 0.025,以及在 BookWiki 数据集上训练 RoBERTa 模型时使用BERT_BASE的 0.005。此外,在 NLP 模型中,梯度裁剪也有帮助。
镜像 MADGRAD
MADGRAD 的镜像下降版本也一并提供,名为 madgrad.MirrorMADGRAD。该版本在大规模 Transformer 训练中表现尤为出色,甚至优于 MADGRAD。对于数据集足够大、泛化差距不是主要问题的任务,推荐使用此版本。
由于镜像下降版本不会进行隐式正则化,因此您可以通常使用与其他优化器兼容的权重衰减值。
技术报告
无妥协的自适应性:一种用于随机优化的动量化、自适应、对偶平均梯度方法
我们提出了一种名为 MADGRAD 的新型优化方法,属于 AdaGrad 自适应梯度方法家族。MADGRAD 在多个领域的深度学习优化任务中表现出色,涵盖视觉领域的分类和图像到图像任务,以及自然语言处理中的循环神经网络和双向掩码模型。对于这些任务中的每一项,MADGRAD 在测试集性能上均能与 SGD 和 ADAM 竞争,甚至在传统上自适应方法表现不佳的问题上也能超越它们。
@misc{defazio2021adaptivity,
title={无妥协的自适应性:一种用于随机优化的动量化、自适应、对偶平均梯度方法},
author={Aaron Defazio 和 Samy Jelassi},
year={2021},
eprint={2101.11075},
archivePrefix={arXiv},
primaryClass={cs.LG}
}
结果

许可证
MADGRAD 采用 MIT 许可证 许可。
常见问题
相似工具推荐
openclaw
OpenClaw 是一款专为个人打造的本地化 AI 助手,旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚,能够直接接入你日常使用的各类通讯渠道,包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息,OpenClaw 都能即时响应,甚至支持在 macOS、iOS 和 Android 设备上进行语音交互,并提供实时的画布渲染功能供你操控。 这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地,用户无需依赖云端服务即可享受快速、私密的智能辅助,真正实现了“你的数据,你做主”。其独特的技术亮点在于强大的网关架构,将控制平面与核心助手分离,确保跨平台通信的流畅性与扩展性。 OpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者,以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力(支持 macOS、Linux 及 Windows WSL2),即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你
stable-diffusion-webui
stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面,旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点,将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师,还是想要深入探索模型潜力的开发者与研究人员,都能从中获益。其核心亮点在于极高的功能丰富度:不仅支持文生图、图生图、局部重绘(Inpainting)和外绘(Outpainting)等基础模式,还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外,它内置了 GFPGAN 和 CodeFormer 等人脸修复工具,支持多种神经网络放大算法,并允许用户通过插件系统无限扩展能力。即使是显存有限的设备,stable-diffusion-webui 也提供了相应的优化选项,让高质量的 AI 艺术创作变得触手可及。
everything-claude-code
everything-claude-code 是一套专为 AI 编程助手(如 Claude Code、Codex、Cursor 等)打造的高性能优化系统。它不仅仅是一组配置文件,而是一个经过长期实战打磨的完整框架,旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。 通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能,everything-claude-code 能显著提升 AI 在复杂任务中的表现,帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略,使得模型响应更快、成本更低,同时有效防御潜在的攻击向量。 这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库,还是需要 AI 协助进行安全审计与自动化测试,everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目,它融合了多语言支持与丰富的实战钩子(hooks),让 AI 真正成长为懂上
ComfyUI
ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎,专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式,采用直观的节点式流程图界面,让用户通过连接不同的功能模块即可构建个性化的生成管线。 这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景,也能自由组合模型、调整参数并实时预览效果,轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性,不仅支持 Windows、macOS 和 Linux 全平台,还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构,并率先支持 SDXL、Flux、SD3 等前沿模型。 无论是希望深入探索算法潜力的研究人员和开发者,还是追求极致创作自由度的设计师与资深 AI 绘画爱好者,ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能,使其成为当前最灵活、生态最丰富的开源扩散模型工具之一,帮助用户将创意高效转化为现实。
gemini-cli
gemini-cli 是一款由谷歌推出的开源 AI 命令行工具,它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言,它提供了一条从输入提示词到获取模型响应的最短路径,无需切换窗口即可享受智能辅助。 这款工具主要解决了开发过程中频繁上下文切换的痛点,让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用,还是执行复杂的 Git 操作,gemini-cli 都能通过自然语言指令高效处理。 它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口,具备出色的逻辑推理能力;内置 Google 搜索、文件操作及 Shell 命令执行等实用工具;更独特的是,它支持 MCP(模型上下文协议),允许用户灵活扩展自定义集成,连接如图像生成等外部能力。此外,个人谷歌账号即可享受免费的额度支持,且项目基于 Apache 2.0 协议完全开源,是提升终端工作效率的理想助手。
markitdown
MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具,专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片(含 OCR)、音频(含语音转录)、HTML 乃至 YouTube 链接等多种格式的解析,能够精准提取文档中的标题、列表、表格和链接等关键结构信息。 在人工智能应用日益普及的今天,大语言模型(LLM)虽擅长处理文本,却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点,它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式,成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外,它还提供了 MCP(模型上下文协议)服务器,可无缝集成到 Claude Desktop 等 LLM 应用中。 这款工具特别适合开发者、数据科学家及 AI 研究人员使用,尤其是那些需要构建文档检索增强生成(RAG)系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性,但其核心优势在于为机器