llmfit:用一条命令判断你的硬件能跑哪些大模型
llmfit 根据模型要求检查本地硬件,并推荐适合可用内存和计算的模型和提供程序。
秒懂
- 它是什么?
- llmfit 是一个用 Rust 写的终端工具,它检测本机内存、CPU 和 GPU,再对照内置模型目录给出适配评分。本文介绍它的工作机制、安装方式、局限和替代方案。
- 适合谁用?
- llmfit 适合那些经常在本地跑大模型、又不想每次手动估算显存和速度的工程师,尤其是使用 Ollama、llama.cpp 或 MLX 的用户。它不适合需要精确测量结果的人,因为速度估算基于内存带宽模型,不是实测数据。
- 能商用吗?
- 可以。MIT 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
- 还在维护吗?
- 在维护。仓库最近一次提交在 2 天前。
- 用什么语言写的?
- 主要是 Rust(依据 GitHub 的语言统计)。
以上回答依据项目的 GitHub 数据(最近同步于 2026年9月15日)和我们的分析,不构成法律意见。
开源项目深度解析
它解决的是选择困难,不是运行问题
本地跑大模型的痛点不在下载,而在选型。同一个模型有不同量化版本,同一个硬件跑不同架构差异巨大。llmfit 把这件事压缩成一条命令:检测硬件,比对目录,输出评分。它不做推理,不启动服务,只负责告诉你哪个模型值得试。目标用户是那些已经装了 Ollama 或 llama.cpp、却还在用试错法找模型的人。
评分机制:四个维度,一个带宽模型
llmfit 对每个模型打四个分数:内存适配、估算速度、质量和上下文。内存适配看的是模型参数量与量化位数是否落在你的 RAM 或 VRAM 范围内。速度估算基于内存带宽模型,这个模型从运行时采样和社区实测数据中校准。关键点是每个估算都附带输入参数,llmfit info 能显示一个数字背后假设了什么,比如带宽值、量化类型、激活内存。这意味着估算不是黑盒,你可以自己核对。MoE 架构被单独处理,Mixtral 这类模型只按活跃参数子集计算内存,而不是总参数量。
安装方式多,但最省事的是包管理器
项目提供了六种安装路径。Windows 用 scoop install llmfit。macOS 和 Linux 推荐 Homebrew,有预编译二进制,也可以用 homebrew-core 的源码构建。MacPorts 也有。不想装包管理器的话,curl 脚本可以装到 /usr/local/bin 或 ~/.local/bin。uv 用户能直接 uv tool install -U llmfit,甚至用 uvx llmfit 临时运行。Docker 镜像 ghcr.io/alexsjones/llmfit 默认输出 recommend 的 JSON,适合脚本消费。从源码构建需要 Rust 工具链,cargo build --release 后二进制在 target/release/llmfit。
TUI 与 CLI:交互式筛选和脚本化输出
默认启动是交互式 TUI,顶部显示检测到的硬件规格,下方是所有模型的评分表。TUI 里还能做规划、模拟下载,甚至直接发起基准测试。对脚本和 agent 来说,llmfit fit 输出表格,llmfit recommend --json 输出结构化 JSON,llmfit info "<model>" 给出单个模型的详细分析和验证命令。llmfit bench 用来测量实际 tok/s 和 TTFT,llmfit doctor 生成硬件检测报告,方便提交 bug。CLI 模式适合管道操作,比如配合 jq 提取模型名。
基准测试与社区共享:估算能被实测替代
项目最近加入了基准测试功能。你可以下载模型、启动服务、用 llmfit bench 测量真实速度,然后直接把结果作为 PR 提交回项目。不需要 gh CLI,不需要第三方账号。每次运行先保存在本地,你自己的测量会替换评分表中的估算值。合并后的提交会随下一个版本发布,这样相同硬件的人能直接看到带对勾的实测数字。这个设计把估算从静态数据变成了可更新的众包数据。不过要注意,这依赖社区持续贡献,如果没人提交,估算依然是估算。
局限:估算不是实测,目录需要维护
llmfit 的速度分数是估算,不是测量结果。内存带宽模型再怎么校准,也无法精确预测每台机器的实际表现,尤其是 CPU 推理受散热和频率调度影响很大。另外,模型目录是内置的,虽然支持自定义模型,但新模型出现后需要等更新或自己添加。项目欢迎贡献新模型,但这对普通用户意味着热门新模型可能不在列表里。还有一个边界:它只评估模型能否运行,不评估输出质量,质量分数可能来自元数据而非实际评测。
替代方案:llm-checker 走的是实测路线
README 里提到了 llm-checker,一个 Node.js CLI 工具,集成 Ollama。它的思路完全不同:不估算,直接通过 Ollama 拉取模型并运行基准测试。如果你已经装了 Ollama,想看到真实性能,llm-checker 更直接。但它不支持 MoE 架构,所有模型都按密集模型处理,所以 Mixtral 或 DeepSeek-V3 的内存估算会按总参数量算,导致结果偏高。llmfit 的估算模型虽然可能不准,但至少对 MoE 有专门处理。选哪个取决于你更在意速度估算的保守性,还是实测的准确性。
维护与许可:MIT 协议,Windows 签名
项目使用 MIT 许可证,可以自由使用和修改。Windows 的发布二进制通过 SignPath.io 做了 Authenticode 签名,这对企业环境部署很重要,能避免 SmartScreen 警告。代码签名在发布流水线中自动完成。更新频率看起来是月度级别,最近几个版本间隔约一周到十天。升级成本低,因为它是单一二进制,替换即可。如果你从源码构建,需要保持 Rust 工具链更新。整体维护状态健康,有 CI 和文档,但文档分散在多个 docs 目录下,初次阅读需要花点时间。
编辑结论
llmfit 适合那些经常在本地跑大模型、又不想每次手动估算显存和速度的工程师,尤其是使用 Ollama、llama.cpp 或 MLX 的用户。它不适合需要精确测量结果的人,因为速度估算基于内存带宽模型,不是实测数据。也不适合完全离线环境,因为模型目录需要从内置数据读取,虽然可以自定义模型,但首次使用仍需了解目录结构。在采用前,建议先运行 llmfit doctor 确认硬件检测是否准确,再用 llmfit info "<model>" 查看某个模型的估算依据,最后用 llmfit bench 实测一次 tok/s,对比估算与实际差距。如果差距过大,说明你的硬件带宽特性与模型假设不符,此时应优先参考实测数据而非估算评分。
社区笔记