Skip to content

deepseek-harness-termux

⭐ 37 · ✅ active · client · ⬆️ +2 recently
Type client Category Mobile
Stars ⭐ 37 Status ✅ active
Author Vengisk Updated 2026-08-19

One-liner

Run @deepseek-ai/dsh on Android/Termux.

About

Run the full DeepSeek Harness (@deepseek-ai/dsh) on Android / Termux — no features disabled. --- deepseek-harness-termux is a community-maintained compatibility layer that ports the official @deepseek-ai/dsh agent harness to Android environments running Termux. The official npm package is built for glibc-based Linux distributions and depends on several native modules that fail to compile or misbehave on Android's Bionic libc. Instead of disabling plugins that depend on those modules, this repository patches the source code so every feature works on Termux. All required patches were generated automatically against the pristine upstream tarballs (`@deepseek-a

✨ Key Features

  • Android 8+ recommended (older versions may work but are untested)
  • Termux from F-Droid (the Play Store version is unsupported and outdated)
  • Node.js >= 24, npm, and the build toolchain for native modules:
  • Internet connection for downloading packages

📦 Install

# Clone this repository
git clone https://github.com/Vengisk/deepseek-harness-termux.git
cd deepseek-harness-termux

# Run the automated installer (installs dsh, applies patches, builds node-pty)
bash install.sh

🚀 Quick Start

# Recommended: fully self-contained (whole patched dsh + node_modules, ~57 MB)
npm i -g https://github.com/Vengisk/deepseek-harness-termux/releases/latest/download/dsh-termux-full.tgz
dsh web

📚 Learn more

Plan A — compile on device (install.sh)

Full control, works on any arm64 Termux; compiles node-pty/koffi once (clang + cmake + NDK sysroot needed, ~5–10 min):

**Run the automated installer (installs dsh, applies patches, **

bash install.sh The installer is idempotent — re-running it skips already-applied patches and already-built artifacts. After install, dsh is usable directly: the installed bin.js shebang is patched with --expose-internals (so npm's dsh bin works in any shell), and a dsh alias is auto-appended to ~/.bashrc (created if missing, or ~/.zshrc for zsh) — your existing shell config is never

How installation script work

  1. Installs @deepseek-ai/dsh globally. 2. Applies the Android source patches under patches/ to the installed packages. 3. Builds the native addons (koffi, node-pty) against the Termux bionic sysroot — the build environment (node headers, GYP_DEFINES, the common.gypi fix) is prepared and the source patches are applied before anything compiles. 4. **Patches `k