guzhou079-arch/deepseek-harness-android
AI EngineeringAn Android APK that bundles DeepSeek Harness with screen automation, virtual display, scheduled tasks and 27 skills, without Termux or root.
What it is
This project packages DeepSeek Harness, DeepSeek's agent engine, as a directly installable Android app. The stated goal is to remove the usual setup work: no Termux, no root and no PC. After installing the APK and entering a model API key, the user gets an agent that can read the screen, tap, type, run in a virtual display and execute scheduled tasks. The package also bundles 27 skills, including divination charts, screen-free control, architecture diagrams, presentation decks, short-video storyboards, memory, Office batch processing, Word documents, Excel multi-sheet work, meeting notes, local RAG, site backups, web scraping and data insight.
The build is a personal port and enhancement effort. It is based on the Android shell skeleton from woaiys3/deepseek-harness-android-app (MIT), contains the build output of @deepseek-ai/dsh (MIT), and includes virtual-screen code ported or aligned from Operit's shower module (LGPL-3.0). The README lists 25 Android adaptation patches across system capabilities, engine adaptation, security hardening, UI and login, plus self-developed plugins whale-shota and dsh-android-ui; see the project README.
Quick start
- Open the latest release and download
DeepSeekHarness-vX.Y-dist.apk(about 192 MB; Android 8.0 or later). - Install it and follow the first-run guide to grant permissions such as accessibility, notifications and overlay; these can be revoked in system settings at any time.
- Enter your own model API key on the settings page to start chatting.
Each release notes includes an SHA-256 checksum for the APK, so verify the download before installing. Detailed requirements and permission notes are in installation and requirements and permissions and privacy.
On-device building
The distinctive feature is that the app can build, repackage, sign and release itself on the phone: proot + Alpine + OpenJDK 17 → javac → d8 → repackage → sign. The build environment is not inside the APK; it is downloaded on demand from the console (about 193 MB). Usage and pitfalls are documented in self-built environment and packaging.
Constraints and caveats
- The app is signed with the project's own key. Installing another build with the same name from a different source (the upstream original or a forwarded APK) will fail with a signature conflict. Do not uninstall to work around
INSTALL_FAILED_UPDATE_INCOMPATIBLE, because uninstalling clears private app data such as session history, runtime environment and configuration. Back up first via Console → Rescue → Export all data; see upgrade and rescue. - Screen reading, tapping, notifications and virtual display all depend on Android accessibility and overlay permissions, and Shizuku is used as a privileged channel. These permissions are sensitive and should be reviewed before granting.
- The project is an individual port, not an official DeepSeek release. The README states that the upstream shell is MIT, the DSH engine is MIT and the virtual-screen portion is LGPL-3.0; it also says the package does not modify or bypass any paid mechanism.
- The README mentions GitHub mirror prefixes (for example
https://ghproxy.net/) for users who cannot reach GitHub directly; these are third-party proxies, not project-controlled infrastructure.
HotRepo's take
No HotRepo ranking, snapshot or discussion history is available for this repository, so the observations here rest on the technical facts in the README. The project's value proposition is concrete: packaging an agent engine into an APK removes Termux and PC setup, and the virtual-display approach keeps the main screen usable while the agent works. The self-building chain on the phone is unusual and shows that the app carries real build tooling rather than just a WebView shell. At the same time, this is a personal redistribution with its own signing key and a large prebuilt APK, so users should check the release checksum and back up data before upgrades.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- kilolonion/agent-vscreenRun Android apps on an invisible virtual display so phone AI agents can operate them while you keep using your own screen.
- ybblab/DroidanceAn open-source Android agent that sees the screen and taps through apps for you in a background virtual display.
- ZSeven-W/dsh-androidDeepSeek Harness plugin that streams a live Android emulator or USB device into the conversation and drives it through adb.
- ccch1mneyyy/dsh-GoAndroid client for DeepSeek Harness that runs the coding agent on-device or connects to a remote host.
- Verlintas/NovaBAICLocal-first Android AI agent that calls 58 device tools to read the screen, automate UI, manage files and run scheduled tasks.