whichllm：一句话找出最适合你硬件的本地大模型

whichllm 是什么

whichllm 是一个开源的 CLI 工具，核心功能就一句话：检测你的硬件配置，从 HuggingFace 实时抓取模型数据，用真实基准评测分数而非参数量来排名，告诉你哪个本地大模型最适合你的机器。

GIF 演示效果：

$ whichllm --gpu "RTX 4090"

#1  Qwen/Qwen3.6-27B     27.8B  Q5_K_M   score 92.8    27 t/s
#2  Qwen/Qwen3-32B       32.0B  Q4_K_M   score 83.0    31 t/s
#3  Qwen/Qwen3-30B-A3B   30.0B  Q5_K_M   score 82.7   102 t/s

这个输出揭示了一个重要洞察：32B 模型明明能塞进 24GB 显存，但 whichllm 仍然把 27B 排在第一，因为它基准评分更高、是更新一代的模型。参数量最大 ≠ 综合体验最好，这正是 whichllm 的核心设计哲学。

核心特性

快速上手

一行命令运行

# 自动检测硬件并推荐（无需安装，临时运行）
uvx whichllm@latest

安装后使用

# 使用 uv 安装
uv tool install whichllm
uv tool upgrade whichllm   # 更新

# 或使用 Homebrew
brew install andyyyy64/whichllm/whichllm

# 或使用 pip
pip install whichllm

常用命令一览

# 检测当前硬件并推荐最佳模型
whichllm

# 模拟特定 GPU
whichllm --gpu "RTX 4090"

# CPU-only 模式
whichllm --cpu-only

# 只显示最佳结果，输出 JSON
whichllm --top 1 --json

# 控制排名数量
whichllm --top 20

# 筛选量化级别
whichllm --quant Q4_K_M

# 按任务筛选
whichllm --profile coding

各硬件平台的最佳推荐

以下数据基于 2026 年 5 月的实时 HuggingFace 数据（whichllm 始终拉取最新数据，此表仅为快照参考）：

为什么需要 whichllm

传统方法的问题

把模型塞进显存只是第一步。更难的是知道「塞进去的那么多模型里，哪个体验最好？」 传统做法是看参数量——「32B 比 27B 大，所以更好」——但这个假设在现实中经常失效。

whichllm 的设计目标就是解决这个问题。

基于证据的排名引擎

引入新视角：whichllm 让本地大模型的选择从「能不能跑」进化到了「哪个最好」，这对日益丰富的本地模型生态来说意义重大。

评分机制

每个模型获得 0-100 的综合评分。评分由多个因素加权计算：

分数标记系统

输出中每个分数旁附带一个标记，提示用户该分数的证据强度：

深入玩法

GPU 模拟

购买硬件前，先用 whichllm 看看不同 GPU 的推荐效果：

# 模拟不同显卡的推荐结果
whichllm --gpu "RTX 4090"
whichllm --gpu "RTX 5090"
whichllm --gpu "RTX 5060 16"   # 指定具体变体

硬件升级规划

对比当前机器和候选升级 GPU 的表现差距：

# 对比三种升级候选
whichllm upgrade "RTX 4090" "RTX 5090" "H100"

# 显示 Top 5 升级对比
whichllm upgrade "Apple M4 Max" --top 5

反向规划：模型到 GPU

想知道跑某个模型需要什么显卡？用 plan：

whichllm plan "llama 3 70b"
whichllm plan "Qwen2.5-72B" --quant Q8_0
whichllm plan "mistral 7b" --context-length 32768

一键运行模型

whichllm 可以自动下载模型并启动交互式聊天：

# 按名称搜索并运行
whichllm run "qwen 2.5 1.5b gguf"

# 自动选择当前硬件最好的模型来聊天
whichllm run

# CPU-only 模式下运行
whichllm run "phi 3 mini gguf" --cpu-only

支持所有流行的模型格式：

• GGUF — 通过 llama-cpp-python 运行
• AWQ / GPTQ — 通过 transformers + autoawq / auto-gptq
• FP16 / BF16 — 通过 transformers

获取 Python 代码片段

whichllm snippet "qwen 7b"

输出示例：

from llama_cpp import Llama

llm = Llama.from_pretrained(
    repo_id="Qwen/Qwen2.5-7B-Instruct-GGUF",
    filename="qwen2.5-7b-instruct-q4_k_m.gguf",
    n_ctx=4096,
    n_gpu_layers=-1,
    verbose=False,
)

output = llm.create_chat_completion(
    messages=[{"role": "user", "content": "Hello!"}],
)
print(output["choices"][0]["message"]["content"])

Ollama 集成

结合 JSON 输出和 jq，可以无缝集成到 Ollama 工作流：

# 获取最佳模型的 HuggingFace ID
whichllm --top 1 --json | jq -r '.models[0].model_id'

# 获取最佳编程模型的 ID
whichllm --profile coding --top 1 --json | jq -r '.models[0].model_id'

Shell alias 一键运行最佳模型：

alias bestllm='whichllm --top 1 --json | jq -r ".models[0].model_id"'
# ollama run $(bestllm)

技术架构

数据管道

1. 模型抓取 — 从 HuggingFace API 拉取热门模型（文本生成、GGUF 过滤、视觉模型）
2. 基准数据 — 分层策略：当前层（LiveBench、Artificial Analysis Index、Aider）实时可获取时优先使用；冻结层（Open LLM Leaderboard v2、Chatbot Arena ELO）作为兜底，带时间衰减
3. 证据解析 — 五级分辨率：direct → variant → base_model → line_interp → self_reported，逐级打折
4. 缓存 — ~/.cache/whichllm/ 下：模型缓存 6h TTL，基准缓存 24h TTL

排名引擎

1. 硬件检测 — NVIDIA（nvidia-ml-py）、AMD（dbgpu/ROCm）、Apple Silicon（Metal）、CPU（核心数、AVX 支持）、内存和磁盘
2. VRAM 估算 — 权重 + KV Cache + 激活内存 + 框架开销（~500MB）
3. 兼容性 — 全 GPU / 部分卸载 / CPU-only；计算能力和操作系统检查
4. 速度预测 — 基于 GPU 内存带宽、量化类型、后端、适配类型和 MoE 激活参数
5. 评分 — 基准（置信度打折）+ 大小 + 量化惩罚 + 适配类型 + 速度 + 流行度 + 来源可信度
6. 后端过滤 — Apple Silicon 和 CPU-only 限制为 GGUF；Linux + NVIDIA 允许 AWQ/GPTQ

项目结构

src/whichllm/
├── cli.py              # 主 CLI 入口
├── hardware/
│   ├── detector.py     # 硬件检测编排
│   ├── nvidia.py       # NVIDIA GPU 检测
│   ├── amd.py          # AMD GPU 检测
│   ├── apple.py        # Apple Silicon 检测
│   ├── cpu.py          # CPU 信息
│   ├── memory.py       # 内存和磁盘
│   └── gpu_simulator.py# GPU 模拟器
├── models/
│   ├── fetcher.py      # HuggingFace API 抓取
│   ├── benchmark.py    # 基准数据处理
│   ├── grouper.py      # 模型家族分组
│   └── cache.py        # 缓存管理
├── engine/
│   ├── vram.py         # VRAM 估算
│   ├── compatibility.py# 兼容性检查
│   ├── performance.py  # 速度预测
│   ├── quantization.py # 量化处理
│   └── ranker.py       # 评分排名
└── output/
    └── display.py      # 输出格式化

优劣势分析

适合谁用

• 本地大模型玩家 — 想找到自己机器上能跑的最佳模型，不用自己逐个测试
• 硬件选购者 — 买显卡前先用 --gpu 模拟不同配置的推荐结果
• 应用开发者 — 需要脚本化选择模型的集成场景（--json 输出）
• LLM 应用快速原型者 — 用 run 和 snippet 快速测试模型效果
• AI 研究者 — 需要批量对比不同硬件配置上的模型表现

总结

whichllm 解决了本地大模型选择中的核心矛盾：能跑的不一定最好，最大的不一定最适合。 它用基于证据的排名引擎，让用户说出「我有什么硬件」就能得到「我应该装哪个模型」的答案。

无论是购买前的硬件规划，还是日常的模型选择，whichllm 都能帮上忙。对于本地 AI 生态来说，它填补了一个有价值的小角落。

项目地址

参考资料

• whichllm GitHub 仓库：项目源代码、README 和全部文档。→ https://github.com/Andyyyy64/whichllm
• HuggingFace 模型中心：whichllm 的模型数据来源。→ https://huggingface.co/models
• PyPI 包：Python 安装来源。→ https://pypi.org/project/whichllm/