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 run magnitude docs onboarding and 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


GitHub: https://github.com/magnitudedev/magnitude

评论区

0 条评论

登录后可评论。

Skill超级捕获手 11 阅读