Magnitude Skill:让 AI Agent 自动切换到免费本地大模型的推理网关
Magnitude 是一个开源推理服务器,能根据你的硬件配置自动筛选并运行最适合的本地大模型,无缝接入已有的 AI Coding Agent 工作流。支持 Pi、OpenCode、Hermes、OpenClaw、Codex、Claude Code、Oh My Pi、Cline 等主流 Agent 框架,一行命令完成硬件探测、模型推荐、本地下载和推理调优。最大卖点是:完全免费、无 API 费用、数据全程本地、离线可用。近期 GitHub 增长迅猛(+130 stars/day),已成为本地模型 + Agent 赛道里的新晋热门选手。
功能与设计原则
Magnitude 核心定位是「Agent 的本地模型网关」。它不是一个通用推理服务,而是一个专为 Agent 工作流设计的推理层:自动探测硬件(CPU/GPU/内存/带宽)→ 从模型目录中推荐最适合的配置 → 下载并调优(投机解码、并发)→ 按需加载/空闲卸载。设计上遵循三条原则:硬件感知(不靠猜测,知道你的芯片和内存能跑什么)、Agent 原生(用一句 prompt 就能让 Agent 自己完成整个配置流程)、零成本运营(完全本地运行,无 token 费用,无 API 限流)。
认可度
- GitHub Star:约 1,800 星(截至 2026-09-04),近 5 天日均 +130 星,Trending 爬升中
- 官方 npm 包
@magnitudedev/cli已发布,Discord 社区活跃 - 在 X/Twitter 上有 Agent 开发者转发切换到本地模型的成功案例(Qwen 3.6 35B-A3B 在 DGX Spark 上跑到 ~60 tok/s)
- 尚未在主流 Skill 市场(Smithery/CocoLoop)看到直接分发,但作为 Agent 工具类项目增长势能强劲
链接
GitHub:https://github.com/magnitudedev/magnitude
原作者
magnitudedev(GitHub 组织),专注 AI 推理基础设施,Magnitude 是其核心项目,Apache 2.0 开源协议。
介绍
Magnitude 起源于一个真实痛点:当你用 Claude Code 或 Codex 时,API 调用有成本、有延迟、数据要上云。现有本地推理方案(Ollama、LM Studio)需要人工选模型、猜量化参数、不了解你的硬件跑不跑得动。Magnitude 的解法是让整个流程自动化:硬件探测 + 模型推荐 + 推理调优,全部由 CLI 驱动,Agent 自己就能完成,不需要人工干预。
安装后只需要一句 prompt:
“Set up local models for me with the Magnitude CLI. Install it with
npm i -g @magnitudedev/cli, then runmagnitude docs onboardingand follow the instructions.”
Agent 会自动完成硬件 profiling、推荐适合的模型、下载、配置 harness,全部在后台静默运行。
模型按需加载,空闲或内存紧张时自动卸载,不会把机器跑满。推理层针对 Agent 工作负载做了专门优化(投机解码、并发管理),不是通用服务器的直接套用。
特点
- 零配置接入:一行命令
npm i -g @magnitudedev/cli,然后magnitude setup,Agent 自己完成剩余步骤 - 硬件感知推荐:不靠猜测,基于芯片型号/内存/带宽计算最优模型和量化参数
- 完全本地隐私:模型、Prompt、文件全程不离开机器,断网可用
- 无使用成本:无 API Key、无 token 费用、无速率限制
- 支持主流 Agent 框架:Pi、OpenCode、Hermes、OpenClaw、Codex、Claude Code、Oh My Pi、Cline,开箱即用
使用方法
安装:
npm i -g @magnitudedev/cli
初始化(推荐由 Agent 自动完成):
magnitude docs onboarding
CLI 会 interactive 探测硬件,展示推荐模型列表,用户确认后下载并写入 harness 配置。
手动浏览模型目录:
magnitude setup
支持的操作系统:macOS、Linux;Windows 通过 WSL 兼容。
使用场景与人群
适用场景:希望在本地运行大模型以降低成本、对数据隐私有要求、或者网络不稳定无法依赖云端 API 的开发者;需要给团队搭建统一推理层的 AI 工程团队。
目标用户:已经在用 Claude Code/Codex 等 Coding Agent 的开发者;对本地模型部署有需求但不想手动折腾 Ollama 配置的 AI 爱好者;需要离线推理能力的技术团队。
输入与输出案例
场景一:开发者让 Agent 切换到本地模型
Input(对 Agent 说):
“Set up local models for me with the Magnitude CLI.”
Agent 自动执行 npm i -g @magnitudedev/cli && magnitude docs onboarding,探测到 MacBook M3 Pro(36GB 内存),推荐 Qwen 2.5 7B Q4,下载完成后写入 Claude Code 配置,Agent 切换到本地推理,后续所有代码补全和对话无 API 费用。
场景二:团队用 Magnitude 统一推理层
Input(运维脚本):
magnitude setup --model qwen-3.6-35b-a3b --harness opencode
Output:模型下载完成,OpenCode harness 自动配置为使用本地模型,团队成员无需各自配置 API Key,文件全程不外发。
项目地址:https://github.com/magnitudedev/magnitude
评论区
登录后可评论。