mxnet-the-straight-dope
mxnet-the-straight-dope 是一本开源的交互式深度学习教程,旨在通过可运行的代码笔记帮助读者从零掌握深度学习核心概念与 MXNet 框架。它解决了传统技术书籍中理论讲解与实际代码脱节的痛点,将文字说明、数学公式、图表和可执行代码完美融合在 Jupyter Notebook 中,让学习者能够边读边练,即时验证想法。
该项目特别适合希望系统学习深度学习的开发者、研究人员以及高校师生使用。无论是需要夯实线性代数、概率统计等数学基础的新手,还是想要快速上手监督学习、逻辑回归等实战模型的进阶用户,都能从中获益。其独特亮点在于“所见即所得”的教学模式:所有示例均基于 MXNet 的 Gluon 接口编写,既保留了生产级框架的高效性能,又提供了类似 Python 原生编写的简洁体验。此外,项目采用完全开放的社区协作模式,欢迎全球贡献者共同完善内容,并已获得官方中文版支持。虽然该项目现已演进为更完善的《动手学深度学习》(d2l.ai),但其开创性的交互式教学理念仍对 AI 教育领域产生着深远影响。
使用场景
某高校人工智能实验室的研究生团队正试图从零开始掌握深度学习核心算法,并复现经典论文中的模型。
没有 mxnet-the-straight-dope 时
- 理论学习与代码实践严重割裂,学生需先在教材中推导数学公式,再独自摸索如何将其转化为 MXNet 代码,极易出错。
- 缺乏可运行的交互式示例,面对复杂的自动微分(autograd)或线性代数运算,只能依靠静态文档猜测实现细节。
- 社区资源分散且质量参差不齐,寻找一个既涵盖基础概率统计又能直接用于生产环境的高效代码范例如同大海捞针。
- 学习曲线陡峭,从理解概念到动手构建第一个线性回归模型往往需要数周时间,严重拖慢科研进度。
使用 mxnet-the-straight-dope 后
- 实现了“所见即所得”的学习体验,Jupyter Notebook 将数学推导、原理解析与可执行的 Gluon 代码无缝整合,边读边跑。
- 提供从底层原理(Scratch)到高级接口(Gluon)的完整实现路径,学生能清晰对比手动推导与框架调用的差异,彻底吃透算法。
- 内容覆盖从数据操作、概率统计到监督学习的全链路,且所有代码均经过生产级速度优化,可直接作为科研项目的启动模板。
- 借助其中文版资源和开源协作模式,团队快速统一了技术栈,将新成员的上手时间从数周缩短至几天。
mxnet-the-straight-dope 通过将交互式代码与深度理论完美融合,消除了深度学习学习中“懂原理却写不出代码”的核心障碍。
运行环境要求
- Linux
- macOS
- Windows
未说明(项目依赖 MXNet,支持 CPU 及多 GPU 训练,具体显卡型号和 CUDA 版本需参考 MXNet 安装指南)
未说明

快速开始
深度学习——直截了当的指南(已弃用* 请参阅 d2l.ai)
本内容已迁移至《深度学习》一书,该书可在 https://d2l.ai/ 免费获取。
摘要
此仓库包含一系列逐步递进的笔记本,旨在教授深度学习、MXNet 以及 gluon 接口。我们的目标是充分利用 Jupyter 笔记本的优势,将文字、图表、公式和代码整合在同一页面中呈现。如果成功,这将形成一种兼具书籍、课程材料、现场教程辅助工具以及可合法引用实用代码资源的综合性学习材料。据我们所知,目前尚不存在同时满足以下两个条件的资料:(1) 全面覆盖现代深度学习的核心概念;(2) 将引人入胜的教材内容与可运行代码无缝结合。我们将在项目结束时揭晓这一空白是否存在合理的理由。
本书的另一大特色在于其编写方式。我们完全公开地开发这套资源,并将其完整版免费提供给公众。尽管本书由几位主要作者负责设定基调和内容框架,但我们欢迎社区贡献,期待与领域专家及社区成员共同撰写章节乃至整部分内容。迄今为止,我们已收到从错别字修正到完整可运行示例的各种贡献。
基于 Apache MXNet 的实现
在本书的整个过程中,我们以 MXNet 为核心工具,讲解深度学习的基础概念、高级主题以及丰富的应用场景。MXNet 因其卓越的速度表现而广泛应用于生产环境。如今,借助 MXNet 的全新命令式接口 gluon(处于 Alpha 阶段),研究人员可以更轻松地开展 MXNet 相关工作。
依赖项
要运行这些笔记本,您需要从源码编译 MXNet。幸运的是,按照 这些说明,这一过程非常简单(尤其是在 Linux 系统上)。此外,您还需要 安装 Jupyter,并使用 Python 3(因为现在是 2017 年)。
幻灯片
作者及其他人士正越来越多地基于本书内容进行演讲。其中一些演示文稿(例如长达 6 小时的 KDD 2017 演讲)篇幅巨大,因此我们将其单独收集在 这个仓库 中。如果您希望分享基于本书的教程或课程材料,欢迎向该仓库贡献内容。
翻译
在编写本书的过程中,规模较大的稳定章节正在同步翻译成中文,既提供 网页版本 ,也通过 GitHub 源代码 提供。
目录
第一部分:深度学习基础
第1章:速成课程
第2章:监督学习入门
第3章:深度神经网络 (DNNs)
第4章:卷积神经网络(CNN)
第5章:循环神经网络(RNN)
- 简单 RNN (从头实现)
- LSTM RNN (从头实现)
- GRU (从头实现)
- RNN (使用
gluon) - 路线图 循环网络中的 Dropout
- 路线图 Zoneout 正则化
第6章:优化
第7章:分布式与高性能学习
- 快速灵活:结合命令式与符号式网络的 HybridBlocks
- 使用多块 GPU 训练(从头实现)
- 使用多块 GPU 训练(使用
gluon) - 使用多台机器训练
- 路线图 异步 SGD
- 路线图 弹性 SGD
第二部分:应用
第8章:计算机视觉(CV)
第9章:自然语言处理(NLP)
- 路线图 词嵌入(Word2Vec)
- 路线图 句子嵌入(SkipThought)
- 路线图 情感分析
- 路线图 序列到序列学习(机器翻译)
- 路线图 带注意力机制的序列转换(机器翻译)
- 路线图 命名实体识别
- 路线图 图像字幕生成
- 用于语义相关性的树LSTM
第10章:音频处理
- 路线图 自动语音识别简介
- 路线图 连接主义时序分类(CSC)用于未对齐序列
- 路线图 结合静态与序列数据
第11章:推荐系统
- 推荐系统简介
- 路线图 隐因子模型
- 路线图 深度隐因子模型
- 路线图 双线性模型
- 路线图 从隐式反馈中学习
第12章:时间序列
- 预测简介 (使用
gluon) - 广义线性模型/MLP用于预测 (使用
gluon) - 路线图 用于预测的因子模型
- 路线图 用于预测的循环神经网络
- 线性动态系统 (从头实现)
- 指数平滑与创新状态空间建模 (从头实现)
- 路线图 用于预测的高斯过程
- 路线图 贝叶斯时间序列模型
- 路线图 缺失数据建模
- 路线图 结合静态与序列数据
- 预测简介 (使用
第三部分:高级方法
第13章:无监督学习
- 路线图 自编码器简介
- 路线图 卷积自编码器(引入上采样)
- 路线图 去噪自编码器
- 变分自编码器
- 路线图 聚类
第14章:生成对抗网络(GANs)
- GANs简介
- 深度卷积GANs(DCGANs)
- 路线图 Wasserstein-GANs
- 路线图 基于能量的GANs
- 路线图 条件GANs
- 图像转换GANs(Pix2Pix)
- 路线图 从合成和无监督图像中学习
第15章:对抗学习
- 路线图 双样本检验
- 路线图 寻找对抗样本
- 路线图 对抗训练
第16章:张量方法
- 张量方法简介
- 路线图 张量分解
- 路线图 张量化神经网络
第17章:深度强化学习(DRL)
- 路线图 强化学习简介
- 路线图 深度上下文多臂赌博机
- 深度Q网络(DQN)
- 双DQN
- 路线图 策略梯度
- 路线图 演员-评论家梯度
第18章:变分方法与不确定性
- 路线图 基于Dropout的不确定性估计(BALD)
- 权重不确定性(反向传播贝叶斯)从零开始
- 权重不确定性(反向传播贝叶斯)使用
gluon - 权重不确定性(反向传播贝叶斯)用于循环神经网络
- 路线图 变分自编码器
第19章:图神经网络
附录
- 附录1:备忘单
- 路线图
gluon - 路线图 PyTorch转MXNet(正在进行中)
- 路线图 TensorFlow转MXNet
- 路线图 Keras转MXNet
- 路线图 数学转MXNet
- 路线图
自选冒险
我们设计这些教程时,旨在让您以多种方式学习整个课程内容。
- 无政府主义者——想读什么就读什么,什么时候读都行。
- 帝国主义者——按顺序完成所有教程。这样您将首先从零开始接触每个模型,自己编写所有代码,仅使用基础的线性代数原语和自动微分功能。
- 资本主义者——如果您不关心底层原理(或者已经了解),只想快速查看使用 Gluon 的可运行代码,那么您可以跳过“从零开始!”的教程,直接进入基于 Gluon 高级接口的生产级代码部分。
作者
这部不断发展的作品是一项协作成果(请参阅“贡献者”标签页)。主要撰写、整理和编码人员包括:
- 扎卡里·C·利普顿(@zackchase)
- 穆·李(@mli)
- 亚历克斯·斯莫拉(@smolix)
- 盛·扎(@szha)
- 阿斯顿·张(@astonzhang)
- 乔舒亚·Z·张(@zhreshold)
- 埃里克·俊元·谢(@piiswrong)
- 卡米亚尔·阿齐扎德内舍利(@kazizzad)
- 让·科萨伊菲(@JeanKossaifi)
- 斯特凡·拉班瑟(@steverab)
灵感来源
在编写这些教程的过程中,我们从过去帮助我们使用其他库学习深度学习或机器学习的一些资源中汲取了灵感。其中包括:
- 苏米思·钦塔拉的《用 PyTorch 进行深度学习:60 分钟速成》
- 阿莱克·拉德福德的《Theano 入门基础教程》
- 阿莱克关于使用 Theano 进行深度学习的介绍视频
- 克里斯·毕晓普的《模式识别与机器学习》
参与贡献
自项目启动以来的短时间内,社区已为我们提供了许多有益的拉取请求,其中包含教学建议、错别字修正以及其他实用改进。如果您愿意,欢迎参与贡献!
版本历史
v0.32017/11/16v0.22017/09/12v0.12017/08/08常见问题
相似工具推荐
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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能,使其成为当前最灵活、生态最丰富的开源扩散模型工具之一,帮助用户将创意高效转化为现实。
NextChat
NextChat 是一款轻量且极速的 AI 助手,旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性,以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发,NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。 这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言,它也提供了便捷的自托管方案,支持一键部署到 Vercel 或 Zeabur 等平台。 NextChat 的核心亮点在于其广泛的模型兼容性,原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型,让用户在一个界面即可自由切换不同 AI 能力。此外,它还率先支持 MCP(Model Context Protocol)协议,增强了上下文处理能力。针对企业用户,NextChat 提供专业版解决方案,具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能,满足公司对数据隐私和个性化管理的高标准要求。
ML-For-Beginners
ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程,旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周,包含 26 节精炼课程和 52 道配套测验,内容涵盖从基础概念到实际应用的完整流程,有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。 无论是希望转型的开发者、需要补充算法背景的研究人员,还是对人工智能充满好奇的普通爱好者,都能从中受益。课程不仅提供了清晰的理论讲解,还强调动手实践,让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持,通过自动化机制提供了包括简体中文在内的 50 多种语言版本,极大地降低了全球不同背景用户的学习门槛。此外,项目采用开源协作模式,社区活跃且内容持续更新,确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路,ML-For-Beginners 将是理想的起点。
ragflow
RAGFlow 是一款领先的开源检索增强生成(RAG)引擎,旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体(Agent)能力相结合,不仅支持从各类文档中高效提取知识,还能让模型基于这些知识进行逻辑推理和任务执行。 在大模型应用中,幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构(如表格、图表及混合排版),显著提升了信息检索的准确度,从而有效减少模型“胡编乱造”的现象,确保回答既有据可依又具备时效性。其内置的智能体机制更进一步,使系统不仅能回答问题,还能自主规划步骤解决复杂问题。 这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统,还是致力于探索大模型在垂直领域落地的创新者,都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口,既降低了非算法背景用户的上手门槛,也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目,它正成为连接通用大模型与行业专有知识之间的重要桥梁。