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:
| Approach | What Separates the Engine from Android | Real-World Cold Boot Time | Low-End Device Behavior |
|---|---|---|---|
| Manual Termux Setup | Perl/Bash scripts + apt repositories + dynamic environment variables | Several minutes during initial setup | Vulnerable to path conflicts |
| PRoot Container | PRoot system call emulation + heavy glibc rootfs | 15 seconds to over a minute | Triggers immediate OOM crashes on 3 GB RAM devices |
| Pre-Bundled Rootfs Snapshot | Unpacks disk archive on launch + patches symlinks | 20 to 40 seconds | Excessive flash storage wear and memory consumption |
| DSH Mobile (This Project) | Zero intermediate layers: direct execve of native bionic Node | 3-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/uhidvirtual 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 accessaptor 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 Variant | Download Size | Internal Architecture | Recommendation |
|---|---|---|---|
| Full Build (Release) | ~161 MB | Bundles 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 MB | Contains the core Android host application and MANIFEST.json manifest | Ideal for metered connections; fetches the runtime archive on initial launch |
🚀 Fast Download Links via GH-Proxy
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)
- Standard Android Phones (ARM64 Full Bundle, ~161 MB): Download dsh-android-v1.5.0-arm64-v8a-release.apk
- Standard Android Phones (ARM64 Lite Package, ~34 MB): Download dsh-android-v1.5.0-arm64-v8a-release-noruntime.apk
- Desktop Android Emulators (x86_64 Full Bundle): Download dsh-android-v1.5.0-x86_64-release.apk
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
- Install and Grant Permissions: Launch the application and approve storage access and notification permissions to keep background execution active;
- Configure API Endpoints: Open Settings to enter your DeepSeek API Key (supports official DeepSeek endpoints or custom OpenAI-compatible proxies);
- 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.
🔗 Related Resources and Project Links
- DSH Mobile Repository: Soodok/Deepseek-Harness-Local-Android
- Upstream DeepSeek Harness Project: deepseek-ai/deepseek-harness
- GH-Proxy Acceleration Portal: gh-proxy.org Home