whatisit-nl2sh

说人话就能生成 shell 命令，本地 CPU 一秒出结果

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署编程开发 🍴 复刻 34 🐛 待处理 5 👀 关注 2

GitHub ↗

GitHub 星标 ★ 646

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源免费，本地运行

项目预览

whatisit-nl2sh 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类编程开发

开发团队ThorOdinson246

GitHubhttps://github.com/ThorOdinson246/whatisit-nl2sh

定价模式🏷️完全免费

价格说明开源免费，本地运行

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

GitHub 星标★ 646

上线时间2026-07-29 00:00:00

代码更新2026-09-28

仓库体积628 KB

本站数据更新2026-11-04

维护状态维护中

收录时间2026-09-16

浏览次数1

项目介绍

whatisit-nl2sh 是一个把自然语言直接翻译成 shell 命令的本地工具。它基于微调后的 Qwen2.5-Coder-1.5B 模型，模型体积约 941 MB，完全在 CPU 上运行，单次生成耗时约 1 秒，不需要联网或调用云端 API。用户输入类似“找出当前目录下最大的十个文件”这样的描述，它就能输出对应的 shell 命令，解决记不住复杂参数、临时查 man 手册效率低的问题。核心能力包括：纯本地推理、隐私安全、低硬件门槛、快速响应，以及针对 shell 场景的指令微调。项目用 Python 实现，适合集成到终端工作流中，作为命令行的自然语言入口。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 646

使用教程

难度：进阶约 30 分钟部署方式：本地安装 5 步

环境要求

Python 3.10+
llama.cpp 与 gguf 模型
约 2G 内存

安装与启动步骤

1用 pipx 装

命令行工具，pipx 能隔离环境，避免污染其他项目。
```
pipx install whatisit
```
2下量化模型

它跑本地小模型，官方给几个 gguf 版本，按内存选大小。
3接 llama.cpp

setup 要同时指定模型文件与本地推理可执行目录。
```
whatisit setup --model ./nl2sh-1.5b-Q4_K_M.gguf --bin-dir /path/to/llama.cpp/bin
```
4描述一句拿命令

给一句自然语言，它返回一条 shell 命令。
5审过再执行

本地小模型会给出错的或危险的命令，执行前必须自己读一遍。