Blog / · GH-Proxy Team

DSH Mobile: Native DeepSeek Agent on Android

As the DeepSeek series of open foundation models captures widespread acclaim across the global AI ecosystem, the official autonomous agent framework DeepSeek Harness (known as dsh, distributed on npm as @deepseek-ai/dsh) has gained significant popularity among software engineers for its clean architecture, flexible tool integration, and efficient reasoning workflows.

However, running a full Node.js agent framework on mobile devices has historically posed severe operational bottlenecks. Existing approaches require configuring complex Termux environments with manual package chains, or deploying heavy proot containers with massive glibc disk images (ranging between 500 MB and 2 GB). These legacy solutions suffer from cold boot times spanning dozens of seconds and frequently crash on memory-constrained devices.

The open-source project Soodok/Deepseek-Harness-Local-Android (known as DSH Mobile) redefines mobile agent architecture with an elegant engineering breakthrough:

No Root, no Termux, and no desktop computer required. The entire Node.js runtime is compiled as native Android bionic binaries bundled directly inside the APK, achieving ready-to-run cold boots in approximately 3 seconds.


⚡ Architectural Advantage: Why Cold Boot Takes Only 3 Seconds

Most existing mobile agent projects remain sluggish because they construct artificial, multi-layered environments on top of Android:

ApproachWhat Separates the Engine from AndroidReal-World Cold Boot TimeLow-End Device Behavior
Manual Termux SetupPerl/Bash scripts + apt repositories + dynamic environment variablesSeveral minutes during initial setupVulnerable to path conflicts
PRoot ContainerPRoot system call emulation + heavy glibc rootfs15 seconds to over a minuteTriggers immediate OOM crashes on 3 GB RAM devices
Pre-Bundled Rootfs SnapshotUnpacks disk archive on launch + patches symlinks20 to 40 secondsExcessive flash storage wear and memory consumption
DSH Mobile (This Project)Zero intermediate layers: direct execve of native bionic Node3-second class (~3.4 seconds on flagship hardware)Runs smoothly even on a 3 GB Unisoc smartwatch

DSH Mobile discards the overhead of emulating a generic Linux distribution. All runtime components required by upstream dsh are pre-compiled into native Android bionic binaries. The cold-start routine performs only three minimal operations: validating extraction on first launch, executing the Node engine, and establishing the local 127.0.0.1 loopback socket.


🌟 Comprehensive Capabilities and Advanced Workflows

DSH Mobile ports the full feature set of upstream @deepseek-ai/dsh. All agent sessions, credentials, and project workspaces remain strictly inside your device sandbox:

1. Granular Privilege Tiers

  • Standard Sandbox Tier (No Root Needed): Provides workspace access, file manipulation, shell commands, interactive PTY terminal sessions, the plugin system, and standard Android notifications and battery status inspection.
  • Shizuku Debugging Tier: Connects with Shizuku via wireless debugging to access ADB-level automation and resilient background execution.
  • Root Tier (Optional): Reserved strictly for advanced system-level routines, such as /dev/uhid virtual hardware peripheral emulation, UID-based firewall rules, and battery optimization whitelisting.

2. Dual Execution Paths: Native Mode and Linux Workspace

  • Native Bionic Mode (Default): Zero emulation overhead, minimal memory consumption (under 400 MB under concurrent load), and near-instant 3-second startup.
  • Linux Workspace (Optional): Includes a custom rootless container component named dsh_alpine, utilizing seccomp to eliminate ptrace overhead. Users can mount lightweight Alpine or Ubuntu user environments on demand to access apt or pre-compiled glibc packages.

3. Cross-Device Workflow and Local Network WebUI

  • Users can interact with the agent through the responsive on-device interface or activate the Local Network WebUI in application settings.
  • DSH Mobile establishes an authenticated local reverse proxy protected by a dynamic 6-digit one-time code, allowing developers to manage the mobile agent from a desktop browser and mechanical keyboard.

📱 Choosing the Right Package: Full vs Lite

The official repository provides two distinct distribution builds:

Package VariantDownload SizeInternal ArchitectureRecommendation
Full Build (Release)~161 MBBundles the complete bionic Node runtime directly in the APK (~130.8 MB compressed, 418 MB extracted)Recommended: Fully self-contained and operates entirely offline immediately after installation
Lite Build (noruntime)~34 MBContains the core Android host application and MANIFEST.json manifestIdeal for metered connections; fetches the runtime archive on initial launch

Accessing GitHub Releases directly from certain networks can encounter severe throttling or dropped connections. By leveraging the GH-Proxy open-source mirror, you can download official installation packages at maximum connection speed.

Direct Official Release Downloads (v1.5.0)

Terminal Command Download (Termux or Linux Shell)

To download the installation package directly using a command line:

curl -L -O https://gh-proxy.org/https://github.com/Soodok/Deepseek-Harness-Local-Android/releases/download/v1.5.0/dsh-android-v1.5.0-arm64-v8a-release.apk

Verify archive integrity against official SHA256 checksums:

sha256sum dsh-android-v1.5.0-arm64-v8a-release.apk

🛠️ Quick-Start and Initial Setup

  1. Install and Grant Permissions: Launch the application and approve storage access and notification permissions to keep background execution active;
  2. Configure API Endpoints: Open Settings to enter your DeepSeek API Key (supports official DeepSeek endpoints or custom OpenAI-compatible proxies);
  3. Execute Agent Tasks: Type your task instructions into the prompt bar to analyze repositories, run automated testing scripts, or build custom workflows with native mobile performance.

💬 Comments & Discussion

Scroll down to load comments
(or click here to load immediately)