MTPLX 快速上手教程：5 分钟从安装到第一次本地 AI 对话

MTPLX 快速上手教程5 分钟从安装到第一次本地 AI 对话【免费下载链接】MTPLXThe fastest way to run Qwen 3.8 Flash Next, Qwen 3.8 27B and Ternary Bonsai 2 27B on a Mac: 125 tok/s in OpenCode on an M5 Max, and a 27B model on 16 GB Macs. Native MTP speculative decoding on Apple Silicon, exact at any temperature. OpenAI and Anthropic compatible local server.项目地址: https://gitcode.com/gh_mirrors/mt/MTPLX想让 AI 大模型在 Mac 上跑得飞快MTPLX 本地 AI 推理工具就是为此而生它是专为 Apple SiliconM 系列芯片设计的 Mac 原生应用与命令行工具内置 MTP 多 token 预测推测解码可让 Qwen 3.8 Flash Next 在 M5 Max 上达到 125 tok/s并让 27B 模型跑进 16 GB 内存的 Mac同时提供 OpenAI 与 Anthropic 兼容的本地 API 服务。下面带你 5 分钟完成安装发出第一次本地 AI 对话请求。安装前准备确认你的 Mac 符合要求MTPLX 只支持Apple Silicon MacM1 或更新需要macOS 14.0。内存决定你能跑哪个模型你的 Mac 内存推荐模型8–16 GBQwen 3.5 4B16–31 GBTernary Bonsai 2 27B仅约 8.85 GB 下载16 GB Mac 也能跑 27B32 GB 以上Qwen 3.8 27B Optimized Speed编码首选256 GB 以上Qwen 3.8 Flash Next 125B MoE详细要求见 INSTALL.md官方文档见 docs/install.md。三种一键安装步骤任选其一方式 1Mac 桌面应用最简单推荐新手从官网下载 DMG拖入 Applications 即可。应用会自动检查硬件、推荐能放进你内存的模型、下载模型、配置 Python 引擎无需 Homebrew并把mtplx加入 PATH全自动完成。方式 2Homebrew 一行命令brew install youssofal/mtplx/mtplx mtplx doctor --summary # 检查安装是否健康方式 3pip 安装适合 Python 用户python3 -m pip install -U mtplx 从源码运行克隆仓库后执行python -m pip install -e .[dev,server]git clone https://gitcode.com/gh_mirrors/mt/MTPLX注意不要往源码目录里下载模型权重请使用 MTPLX 模型缓存。启动本地服务mtplx start 自动选模型mtplx startMTPLX 会按你的芯片和内存自动挑选推荐模型首次使用需下载模型mtplx pull hf-repo可预先下载。例如手动指定 27B 编码模型mtplx serve --model Youssofal/Qwen3.8-27B-MTPLX-Optimized-Speed服务启动后MTPLX 在http://127.0.0.1:8000上暴露 OpenAI 兼容 API/v1/chat/completions、/v1/models以及 Anthropic 兼容的/v1/messages。发送第一次本地 AI 对话请求打开另一个终端用 curl 发送第一个对话请求示例脚本examples/curl-chat-completions.shcurl http://127.0.0.1:8000/v1/chat/completions \ -H Content-Type: application/json \ -d {model:mtplx,messages:[{role:user,content:你好介绍一下你自己}],stream:true}看到逐字流式返回的回答你就已经拥有了一台本地 AI 推理服务器 。也可以直接用 Python 客户端参考 examples/openai-python-client.py 与 examples/anthropic-python-client.pymtplx chat --model Youssofal/Qwen3.8-27B-MTPLX-Optimized-Speed在 Mac 应用里更简单打开聊天窗口直接提问一键启动 OpenCode、Open WebUI 等任何兼容 OpenAI/Anthropic API 的客户端即可对接本地服务。常用命令速查表命令作用mtplx start交互式选择模型并聊天mtplx serve --port 8000只启动 API 服务器mtplx stop停止正在运行的服务mtplx pull hf-repo下载模型mtplx models查看已缓存模型与大小mtplx doctor安装与健康检查mtplx tune --retune在你的 Mac 上实测并保存最快解码深度mtplx inspect model运行前查看模型兼容性报告更多细节服务器配置见 docs/server.md完整 API 说明见 docs/api.md5 分钟入门见 docs/quickstart.md。进阶玩法从聊天走向生产力自动调优mtplx tune --retune会用真实模型在你的 Mac 上逐一测试解码深度自动保存最快配置——同一模型在不同 Mac 上的最优深度可能不同。RAG 检索同一个服务可同时提供/v1/embeddings与/v1/rerank本地 RAG 不用再另起一个推理服务。Forge 锻造把 Hugging Face 上的任意仓库转换成带 MTP 加速的本地模型并真实测量是否真的更快再给出结论。为什么快模型用自己的 MTP 头提前草拟多个 token一次批量前向验证配合精确拒绝采样——任意温度下结果都准确源码可看 mtplx/speculative.py。装好 MTPLX你的 Mac 就变成了一台高速、离线、完全属于自己的 AI 推理引擎。祝使用愉快【免费下载链接】MTPLXThe fastest way to run Qwen 3.8 Flash Next, Qwen 3.8 27B and Ternary Bonsai 2 27B on a Mac: 125 tok/s in OpenCode on an M5 Max, and a 27B model on 16 GB Macs. Native MTP speculative decoding on Apple Silicon, exact at any temperature. OpenAI and Anthropic compatible local server.项目地址: https://gitcode.com/gh_mirrors/mt/MTPLX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考