ML-Recipes
ML-Recipes 是一个专为机器学习爱好者打造的独立 Python 代码示例合集。它致力于解决学习者在理解复杂算法理论时面临的“纸上谈兵”困境,将抽象的数学公式转化为可直接运行、观察结果的实战代码。无论是经典的感知机、多层感知机,还是进阶的长短期记忆网络(LSTM)、回声状态网络,乃至强化学习中的多臂老虎机策略(如汤普森采样、UCB 等),这里都提供了精简且独立的实现方案。
该项目特别适合开发者、数据科学初学者以及研究人员使用。对于希望快速验证算法逻辑的工程师,或需要参考标准实现以辅助教学的研究者,ML-Recipes 都能提供极大的便利。其独特的技术亮点在于“独立性”与“溯源性”:每个脚本均可单独运行,无需复杂的环境配置;同时,每个示例都严谨地标注了原始学术文献来源,帮助用户在动手实践的同时深入理解算法背后的理论根基。如果你想在几分钟内通过代码直观感受机器学习的运作机制,ML-Recipes 将是你理想的入门指南。
使用场景
某初创公司的算法工程师正在为一款新上线的新闻推荐 App 设计冷启动策略,需要在用户历史数据匮乏的情况下快速验证哪种探索与利用(Exploration vs. Exploitation)算法能最大化点击率。
没有 ML-Recipes 时
- 复现成本高昂:工程师需从零编写 epsilon-greedy、Thompson Sampling 等经典多臂老虎机算法,极易在数学公式转代码时引入隐蔽错误。
- 文献查阅耗时:为了确认算法细节,不得不反复翻阅《Reinforcement Learning: An Introduction》等厚重教材或原始论文,严重拖慢原型开发进度。
- 缺乏基准对比:手头只有单一算法实现,难以快速构建对照组来评估不同策略(如 Softmax 与 UCB)在同一数据集上的表现差异。
- 环境配置繁琐:自行搭建测试环境时,常因依赖库版本冲突或缺少标准测试用例,导致调试时间远超编码时间。
使用 ML-Recipes 后
- 即插即用验证:直接调用
recipes/MAB/thompson.py等独立脚本,几分钟内即可运行并查看标准输出结果,大幅缩短验证周期。 - 权威实现参考:每个食谱都附带清晰的学术引用和简洁代码,工程师可迅速理解核心逻辑,确保算法实现的理论正确性。
- 便捷策略横向测评:轻松并行运行 greedy、softmax、ucb 等多种方案,快速产出对比数据,精准锁定最适合当前业务场景的算法。
- 轻量级集成体验:无需安装庞大的深度学习框架,这些独立的 Python 文件可直接嵌入现有实验流程,零负担完成概念验证(PoC)。
ML-Recipes 将原本需要数天的算法复现与调研工作压缩至小时级,让团队能专注于业务逻辑创新而非重复造轮子。
运行环境要求
- 未说明
未说明
未说明

快速开始
机器学习教程
这是一个包含独立 Python 示例的机器学习算法集合。运行特定的示例以查看其用法和结果。欢迎贡献新的示例(建议示例代码量适中,并包含使用说明)。
多臂老虎机问题 (MAB)
ε-贪婪算法 (recipes/MAB/greedy.py)
萨顿, 理查德·S., 巴托, 安德鲁·G.《强化学习:导论》,麻省理工学院出版社,剑桥,马萨诸塞州(1998年)。
Softmax 策略 (recipes/MAB/softmax.py)
卢斯, R. 邓肯.(1963).“检测与识别”。载于卢斯, R. 邓坎、布什, 罗伯特·R. 和 加兰特, 尤金(编), “数学心理学手册”(第1卷),纽约:威利出版社。
汤普森采样 (recipes/MAB/thompson.py)
汤普森, 威廉·R. 根据两个样本的证据,一个未知概率超过另一个的概率。生物计量学,25(3–4):285–294,1933年。DOI: 10.2307/2332286
上置信界算法 (recipes/MAB/ucb.py)
赖, T.L. 和 罗宾斯, 赫伯特,《渐近有效的自适应分配规则》,应用数学进展6:1,(1985年)DOI: 10.1016/0196-8858(85)90002-8
人工神经网络 (ANN)
自适应共振理论 (recipes/ANN/art.py)
格罗斯伯格, 斯蒂芬(1987)。“竞争性学习:从交互激活到适应性共振”,认知科学,11,23-63页。
回声状态网络 (recipes/ANN/esn.py)
雅格尔, 赫伯特(2001)“回声状态”方法用于分析和训练递归神经网络。GMD 报告 148,德国国家计算机科学研究机构。
简单递归网络 (recipes/ANN/srn.py)
埃尔曼, 杰弗里 L.(1990).“在时间中寻找结构”。认知科学,14:179–211页。
长短期记忆网络 (nicodjimenez/lstm)
霍克赖特, 塞普 和 施密德胡伯, 尤尔根(1997)“长短期记忆”,神经计算第9卷,1735-1780页。
多层感知器 (recipes/ANN/mlp.py)
鲁梅尔哈特, 大卫 E., 辛顿, 吉福德 E. 和 威廉姆斯, 罗纳德 J. “通过误差反向传播学习内部表示”。鲁梅尔哈特, 大卫 E., 麦克莱伦德, 詹姆斯 L. 以及 PDP 研究小组(编辑)。并行分布式处理:认知微观结构探索,第1卷:基础。麻省理工学院出版社,1986年。
感知器 (recipes/ANN/perceptron.py)
罗森布拉特, 弗兰克(1958),“感知器:大脑中信息存储与组织的概率模型”,康奈尔航空实验室,心理评论,第65卷,第6期,pp. 386–408。DOI:10.1037/h0042519
核感知器 (recipes/ANN/kernel-perceptron.py)
艾泽曼, M. A., 布拉韦尔曼, E. A. 和 罗佐诺尔, L.. “模式识别学习中势函数方法的理论基础”。论文发表于自动化与远程控制会议,1964年。
投票感知器 (recipes/ANN/voted-perceptron.py)
Y. 弗伦德, R. E. 施皮雷。“基于感知器算法的大间隔分类”。载于第11届计算学习理论年会,纽约,纽约,209-217页,1998年。DOI:10.1023/A:1007662407062
自组织映射 (recipes/ANN/som.py)
科霍宁, 特乌沃。自组织与联想记忆。施普林格出版社,柏林,1984年。
马尔可夫决策过程 (MDP)
值迭代 (recipes/MDP/value-iteration.py)
贝尔曼, 理查德(1957).“马尔可夫决策过程”。数学与力学杂志,第6期。
降维 (DR)
主成分分析 (recipes/DR/pca.py)
皮尔逊, K.(1901).“关于空间点系的最佳拟合直线与平面”。哲学杂志,2(11):559–572页。DOI:10.1080/14786440109462720
特征脸 (recipes/DR/eigenface.py)
M. 特克 & A. 彭特兰(1991)“用于识别的特征脸”。认知神经科学杂志,3(1):71-86页。DOI:10.1162/jocn.1991.3.1.71
经典多维尺度分析 (recipes/DR/classical_mds.py)
W.S. 托格森(1952)“多维尺度分析:I. 理论与方法”。心理测量学,17:401-419页。DOI:10.1007/BF02288916
相似工具推荐
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 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性,但其核心优势在于为机器
