DeepSeek-TUI 以双 Rust 静态链接二进制文件(deepseek 调度器 + deepseek-tui 运行时)的形式分发,不依赖 Node.js 或 Python 运行时,安装过程非常简洁。根据您的系统环境和已有工具链,可以选择以下任一方式:
方式一:npm 安装(已装 Node.js 的最推荐方式)
npm install -g deepseek-tui说明:npm 包本质上是一个下载器,会从 GitHub Releases 拉取对应平台的预编译二进制文件,并不会让 DeepSeek-TUI 本身依赖 Node.js 运行时。
方式二:Cargo 安装(无需 Node.js)
cargo install deepseek-tui-cli --locked # 提供 `deepseek` 入口命令
cargo install deepseek-tui --locked # 提供 `deepseek-tui` TUI 二进制要求:Rust 1.88+。中国大陆用户可配置 Cargo 清华 TUNA 镜像加速:
# ~/.cargo/config.toml
[source.crates-io]
replace-with = "tuna"
[source.tuna]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"方式三:Homebrew 安装(macOS 推荐)
brew tap Hmbown/deepseek-tui
brew install deepseek-tui方式四:直接下载预编译二进制(无需任何工具链)
访问 https://github.com/Hmbown/DeepSeek-TUI/releases 下载对应平台的二进制文件,放入 PATH 目录即可:
平台 | 文件 |
|---|---|
Linux x64 | deepseek-linux-x64 |
Linux ARM64 | deepseek-linux-arm64(v0.8.8+) |
macOS x64 | deepseek-macos-x64 |
macOS ARM64 | deepseek-macos-arm64 |
Windows x64 | deepseek-windows-x64.exe |
方式五:Docker 运行
docker run --rm -it \
-e DEEPSEEK_API_KEY=$DEEPSEEK_API_KEY \
-v ~/.deepseek:/home/deepseek/.deepseek \
-v "$PWD:/workspace" \
-w /workspace \
ghcr.io/hmbown/deepseek-tui:latest安装后:配置 API Key
安装完成后,需要先配置 DeepSeek API Key 才能使用:
# 方式一:交互式配置(推荐)
deepseek auth set --provider deepseek
# 方式二:环境变量方式
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"
# 验证安装
deepseek --version
deepseek doctorAPI Key 最终保存在 ~/.deepseek/config.toml 中,支持多 profile 管理和随时切换。
中国大陆用户加速提示
使用 npm 安装时,可切换至国内镜像加速下载:
npm config set registry https://registry.npmmirror.com
npm install -g deepseek-tui