Section 01 · 安装

Install 安装

Pick your platform below — we auto-detect on first load. Every method gives you the same binary: a single static deepseek executable that dispatches to the TUI for interactive use and exposes subcommands likedoctor, mcp,serve, eval.

RecommendedMethod 01

Cargo (recommended)

Cargo · 推荐

Prereq: Rust 1.88+ — install via rustup.rs if needed

# Install the dispatcher (provides `deepseek`)
cargo install deepseek-tui-cli --locked

# Optional: also install the raw TUI binary (`deepseek-tui`)
cargo install deepseek-tui --locked

# Set your API key (one-time)
export DEEPSEEK_API_KEY=sk-...
echo 'export DEEPSEEK_API_KEY=sk-...' >> ~/.zshrc

# Run it
deepseek

Method 02

npm wrapper

npm 包

Prereq: Node.js 18+

npm install -g deepseek-tui

# Provides both binaries on PATH:
deepseek          # canonical dispatcher
deepseek-tui      # raw TUI binary

Method 03

Pre-built binary

二进制

Prereq: Apple Silicon (arm64) or Intel (x64). Releases ship raw binaries — no archive to extract.

# Apple Silicon
curl -fsSL -o deepseek \
  https://github.com/Hmbown/deepseek-tui/releases/latest/download/deepseek-macos-arm64
chmod +x deepseek
xattr -d com.apple.quarantine deepseek 2>/dev/null || true
sudo mv deepseek /usr/local/bin/

# Intel
curl -fsSL -o deepseek \
  https://github.com/Hmbown/deepseek-tui/releases/latest/download/deepseek-macos-x64
chmod +x deepseek
xattr -d com.apple.quarantine deepseek 2>/dev/null || true
sudo mv deepseek /usr/local/bin/

# Verify checksum (optional but recommended)
curl -fsSL -O https://github.com/Hmbown/deepseek-tui/releases/latest/download/deepseek-artifacts-sha256.txt
shasum -a 256 -c deepseek-artifacts-sha256.txt --ignore-missing

deepseek

Method 04

Homebrew

Prereq: Homebrew on macOS or Linux; installs the dispatcher and companion TUI from the official Hmbown tap.

brew tap Hmbown/deepseek-tui
brew install deepseek-tui

deepseek --version
deepseek

Method 05

Docker

Prereq: Dockerfile ships with the repo (multi-arch buildx). No prebuilt image is published to a registry yet.

git clone https://github.com/Hmbown/deepseek-tui
cd deepseek-tui

# Build for your local arch
docker build -t deepseek-tui .

# Or multi-arch via buildx
docker buildx build --platform linux/amd64,linux/arm64 -t deepseek-tui .

# Run interactively, mounting your config + a project
docker run --rm -it \
  -e DEEPSEEK_API_KEY=$DEEPSEEK_API_KEY \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  -v "$PWD:/work" -w /work \
  deepseek-tui

Method 06

Build from source

源码编译

Prereq: Rust 1.88+ and a git checkout — useful for hacking on the workspace itself.

git clone https://github.com/Hmbown/deepseek-tui
cd deepseek-tui

# Builds both `deepseek` and `deepseek-tui` into ./target/release/
cargo build --release --locked

# Run without installing
./target/release/deepseek

# Or install both binaries from your local checkout
cargo install --path crates/cli --locked   # provides `deepseek`
cargo install --path crates/tui --locked   # provides `deepseek-tui`

After install 下一步

①
Get a key
Sign up at platform.deepseek.com
You'll get an sk-... API key. Paste it once and deepseek auth will store it in ~/.deepseek/config.toml.
②
Run doctor
Verify your setup
deepseek doctor checks your key, network, sandbox availability, MCP servers, and writes a report to ~/.deepseek/doctor.log.
③
Try it out
First prompt
cd into a project, run deepseek, and ask: "What does this codebase do?" Plan mode is read-only by default — press Tab to switch to Agent mode.

Config files · 配置

Where things live

All configuration goes under ~/.deepseek/. Per-project overrides via project-scoped .deepseek/ config at the repo root.

Full configuration reference →

~/.deepseek/
├── config.toml          # api keys, model, hooks, profiles
├── mcp.json             # MCP server definitions
├── skills/              # user skills (each with SKILL.md)
├── sessions/            # checkpoints + offline queue
├── tasks/               # background task store
└── audit.log            # credential / approval / elevation audit trail

# project-local
./.deepseek/             # project-scoped config (optional)