Hmbown / DeepSeek-TUI

7,187548+2,434 todayRust

View on GitHub

Coding agent for DeepSeek models that runs in your terminal

📊 Project Info

Language: Rust
Stars: ⭐ 7,187
Forks: 548
Today: +2,434
Ranking: #1
Collection: Overall
Trending Date: May 5, 2026
Last Push: 5/5/2026

🏷️ Topics

clideepseekllmrustterminaltui

📸 Screenshots

DeepSeek-TUI 5分钟快速开始

DeepSeek-TUI 是一个终端原生编码代理，专为 DeepSeek V4 模型设计，支持 1M 令牌上下文，单二进制文件即可运行。

🖥️ OS

macOSWindowsLinux

🔧 Tools

终端— 运行命令

📝 Steps

下载预编译二进制文件

从 GitHub Releases 页面下载适合你系统的二进制文件。Linux x64、macOS ARM64 等均有提供。

替换 <your-os> 和 <arch> 为你的系统（如 linux-x64、darwin-arm64）

$ curl -LO https://github.com/Hmbown/DeepSeek-TUI/releases/latest/download/deepseek-<your-os>-<arch>.tar.gz

解压文件

$ tar -xzf deepseek-*.tar.gz

将两个二进制文件移动到 PATH 中

$ sudo mv deepseek /usr/local/bin/ && sudo mv deepseek-tui /usr/local/bin/

✓Expected: 命令执行后无错误输出，deepseek 和 deepseek-tui 命令可用。

💡如果下载慢，可以使用 npm 安装：npm i -g deepseek-tui（需要 Node.js，但仅用于安装）。

设置 API 密钥

首次运行会提示输入 DeepSeek API 密钥，密钥保存在 ~/.deepseek/config.toml。也可以提前设置环境变量。

设置环境变量，替换为你的真实密钥

$ export DEEPSEEK_API_KEY='your-api-key-here'

✓Expected: 无输出，但后续运行不再提示输入密钥。

💡密钥可以从 platform.deepseek.com 获取。

启动 TUI

在终端中运行 deepseek 命令启动 TUI 界面。

启动 DeepSeek-TUI

$ deepseek

✓Expected: 终端显示 TUI 界面，顶部有模式指示器（如 Agent），底部有输入框。

💡如果报错找不到 deepseek-tui，确保两个二进制文件都在 PATH 中。

发送第一条消息

在 TUI 中输入一条简单指令，例如 '列出当前目录文件'，然后按 Enter 发送。

在 TUI 输入框中输入此消息并回车

$ 列出当前目录文件

✓Expected: 模型会思考并执行 ls 命令，然后在界面中显示文件列表。

💡按 Tab 可以自动补全命令或文件路径。

✅ 验证成功

成功看到模型执行命令并返回结果，说明 DeepSeek-TUI 已正常运行。

✓TUI 界面正常显示
✓模型响应并执行了工具调用
✓输出结果包含文件列表或任务完成信息

⚡ Quick Tips

导航按 F1 查看所有快捷键帮助

配置按 Shift+Tab 切换推理强度（off/high/max）

命令输入 /help 查看命令列表

🔍 Troubleshooting

❓ 运行 deepseek 报错 'command not found'

→ 确保二进制文件已移动到 /usr/local/bin 或 PATH 中的其他目录。

❓ 启动后提示 API 密钥未设置

→ 设置环境变量 DEEPSEEK_API_KEY 或运行 deepseek auth set --provider deepseek 交互式输入。

❓ 模型响应慢或超时

→ 检查网络连接，或按 Ctrl+C 取消当前请求后重试。

🎯 Next Steps

阅读文档

查看 docs/ 目录下的详细文档，了解 MCP、会话保存等功能。

尝试 YOLO 模式

在 TUI 中按 Tab 切换到 YOLO 模式，体验自动批准工具调用。

配置项目覆盖

在工作目录创建 .deepseek/config.toml 覆盖全局配置。