ccch1mneyyy/dsh-Go
ccch1mneyyy/dsh-Go has 17,093 GitHub stars and 732 forks. GitHot measured +1,723 stars in 24 hours and +11,261 in 7 days. Last checked 2026-11-09 11:52 UTC. Last push 2026-11-01.
dsh-go — DeepSeek Harness in your pocket: runs locally on your phone and lets you remotely control your computer.
Measured star growth
- in 24h
- +1,723
- in 7 days
- +11,261
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
README.en.md
Original简体中文 · English
An Android client for DeepSeek Harness. Run DSH right on your phone, or drive the one on your computer.
#1 on Trendshift's all-language daily ranking · 2026-10-30
Deepy and Whale girl keep you company
They code, flip, wave and nap along with DSH, and can follow you to the home screen.
Download DSH Go
Get the latest APK from GitHub Releases or the download page at go.dshtui.com. Most phones need the arm64 package.
Thank you all for supporting and loving DSH Go! iOS and HarmonyOS versions are coming as soon as I can make them. The more stars, the faster they come, hehe
New here? Start with the user guide, and bring questions to the forum and QQ group.
An early test build signed with a different key can't be updated in place: uninstall it first, which clears your chats, the Linux environment and settings.
Runs on your phone. Drives your computer.
A Linux environment built in, no root and no Termux. Switch to the DSH on your computer in one tap.
Chime in, interrupt, stay tidy
Send a message while DSH is replying, and tap "Send now" whenever you like. Finished steps fold into one line.
Native, with the web interface one tap away
Switch between the native app and the official web interface on the same chat. It reopens in whichever you used last.
Share cards, replays and links
Turn a reply into a share card. Share a whole chat as a link that replays in any browser, end-to-end encrypted.
Landscape and tablets
New layouts for landscape phones and tablets: the sidebar stays, content stays centered, the keyboard never crowds.
Colors and home screen icons
Six accent colors, your wallpaper's, or your own. Four home screen icons and three icon styles.
English and 中文
The whole app speaks both. It follows your system, or pick one in Settings.
Phone control
DSH reads the screen and taps for you. Sensitive actions stay with you by default; understand the risks before relaxing app rules or lifting limits.
Features
DSH Go combines a chat interface, an on-device runtime and remote connections. It is a third-party project built on DeepSeek Harness. The DSH engine runs on your phone; model requests are still handled by the model provider you configure.
- On-device runtime: install Ubuntu, Node.js and DSH from the app without Root or a separate Termux installation.
- Remote connections: use DSH on a computer or server through SSH or DSHarness Remote, developed by Li Guobao (liguobao).
- Chat and tools: switch models, send images, use voice input, and respond to tool approvals and questions. Chat and web interfaces are available.
- Plugin interfaces: use native tool cards, forms and panels from plugins adapted for DSH Go. This repository includes an SDK, guides and examples.
- Phone control: after you enable the required permissions, let the local engine read the screen, tap and type. You can stop it at any time.
- Sharing and appearance: share, export and replay conversations, and customize themes, icons and pets.
Capabilities depend on the host and connection. DSHarness Remote currently accepts image attachments only, does not open the web interface inside the app, limits plugin management to enabling or disabling plugins, and does not support DS Bot or conversation-log export. See Engine and remote hosts.
Install
Installation requires Android 8.0 (API 26) or later. The arm64 package on the Releases page is for typical 64-bit Android phones; the x64 package for x86_64 devices and emulators is under “Other builds” at the end of the release notes. This repository has no 32-bit ARM build.
- Download the APK for your device architecture from GitHub Releases or the download page, and follow Android's prompt to allow that installation source.
- On first launch, choose an on-device runtime or a remote host.
- Configure a model and its credentials for the selected host, then start a conversation. Some remote providers must be configured on the host itself.
A remote-only setup does not need a local runtime on the phone. Phone control works with the local engine outside safe mode and requires permissions such as Accessibility, as explained in the app. Non-disruptive mode additionally requires Android 14 or later and Shizuku or self-ADB. Follow the user guide for setup.
The local engine uses compatible PRoot startup by default. Direct startup is off by default in Developer options; see Troubleshooting for compatibility and fallback behavior. The current Android build targets APK sideloading, not Google Play distribution.
Data and permissions
Model requests go to the provider you configure. During phone-control tasks, relevant screen text may be sent to the model, and vision-capable models may receive screenshots. Read the app's permission disclosure before enabling the feature.
“Send anonymous usage statistics” is on by default. You can turn it off during onboarding or in Settings → Privacy and sharing. See Troubleshooting for the fields collected and what happens when it is disabled. Review content before sharing it; recipients can save a copy of a shared link or file's contents.
Risks and disclaimer
DSH Go is an unofficial community project. It is not affiliated with, endorsed by, or a representative of DeepSeek. Before using it, please understand:
- AI is fallible: answers, code and actions may be wrong, and malicious instructions in web pages, messages or files may mislead it. Verify important results; do not rely solely on AI output for high-stakes medical, legal or investment decisions.
- Tools have real effects: commands and file changes on local or remote hosts, as well as phone control, may cause data loss, privacy breaches, or harm to accounts, funds or devices. Skipping confirmations, relaxing app rules or lifting limits reduces safeguards; confirmation and blocking mechanisms cannot eliminate all risks. Keep default protections, grant only necessary permissions, and avoid lifting limits on devices holding payment or banking details. See the phone-control guide.
- Third-party services and costs: models, remote hosts and plugins operate under their own terms. Data handling, availability and charges depend on the services and configuration you choose. Running locally does not mean the model is offline or that data never leaves the device.
- Take precautions: back up important data, connect only to trusted hosts, install only trusted plugins, and monitor model usage and costs. Do not leave AI unattended on irreversible or high-risk tasks.
- No warranty and limits of liability: to the extent permitted by applicable law, the software is provided “as is,” without guarantees of accuracy, continuous availability or fitness for a particular purpose. See sections 15–17 of LICENSE for warranty disclaimers and liability limits. This notice does not exclude or limit liability that cannot legally be excluded or limited, or reduce your statutory rights.
FAQ
Is this an official DeepSeek app?
No. DSH Go is an unofficial client made by the community, built on the open-source DeepSeek Harness. DSH itself runs on your phone; model requests go to the provider you configure, so it needs a connection and bills your account with that provider.
Is it safe?
The local web interface only answers to the app itself. Shared links are end-to-end encrypted: the key lives only in the link, and the server never sees the content, but anyone with the complete link can read and save it. Phone control retains sensitive-action protections by default; relaxing app rules or using “Lift limits” reduces those protections. Safeguards cannot guarantee zero risk. See Risks and disclaimer and the phone-control guide.
Will the system kill it in the background?
Some battery savers hold apps back. When that happens, DSH Go tells you and opens the right setting, on vivo, Xiaomi, Huawei, Honor and OPPO.
What phone do I need?
Android 8 or later. On a phone, download the package on the Releases page; the x86_64 build for emulators is under “Other builds” at the end of the release notes. Running DSH on the phone needs the built-in environment, so keep about 1 GB free; connecting to DSH on a computer or server doesn't.
Is it open source?
Yes. The code is in this repository under AGPL-3.0; sdk/ and examples/ are MIT. The DSH Go name and logo, and the mascots Deepy and Whale girl, are not covered by the open-source license; see ASSETS.md. Credit requirements for forks and redistributed builds are in License scope and redistribution.
Build from source
The following workflow targets Linux x86_64. The toolchain script currently defaults to JDK 17, Flutter 3.47.7 and the Android SDK/NDK. The app requires Dart ^3.13.5. Prepare Bash, Git, curl, tar, unzip, xz, Python 3, zstd (for unpacking zstd-compressed deb archives when Python does not provide compression.zstd), file and standard GNU utilities. Resolving Ubuntu package locks again also requires gpgv.
Start with the complete source tree and project assets. Fonts, images and other files declared in app/pubspec.yaml are build inputs. The following script generates the runtime bundle.
git clone https://github.com/ccch1mneyyy/dsh-go.git
cd dsh-go
bash tooling/setup-toolchain.sh
source tooling/env.sh
flutter --version
java -version
bash runtime/build-runtime.sh arm64-v8a
DSH_BETA_TOKEN_FILE= bash tooling/build-apk.sh -f arm64 --keep-daemon
The toolchain script downloads the SDK/NDK and emulator images and runs Android SDK license acceptance. Its default location is ~/dev; set DEV_ROOT to use a separate directory. The script reuses existing installations, so check their versions before building.
The output is app/build/app/outputs/flutter-apk/app-arm64-release.apk. Runtime assembly uses the versions and verification data pinned in the repository and needs network access to download dependencies. DSH_BETA_TOKEN_FILE= leaves out the maintainer's beta-channel token. --keep-daemon preserves Gradle daemons, which is useful when working on other Android projects at the same time.
For an x86_64 APK, generate its runtime first:
bash runtime/build-runtime.sh x86_64
DSH_BETA_TOKEN_FILE= bash tooling/build-apk.sh -f x64 --keep-daemon
Without app/android/key.properties, a local release build uses debug signing. It cannot replace an official installation signed with a different key. Use a test device and preserve existing data; do not uninstall your daily-use app just to resolve a signing mismatch. Do not commit signing keys or their configuration.
To inspect APK build commands without building:
DSH_BETA_TOKEN_FILE= bash tooling/build-apk.sh --dry-run -f all
Repository layout
| Path | Contents |
|---|---|
app/ |
Flutter interface and Android Kotlin platform code |
packages/dsh_client/ |
Dart client for the DSH Web API |
packages/dsh_remote/ |
Dart client for DSH Remote |
runtime/ |
Linux runtime assembly, engine patches and the app bridge |
sdk/plugin-kit/ |
Native plugin authoring kit, used from the repository and not published to npm |
examples/plugins/ |
Example plugins |
docs/guide/, docs/plugins/ |
User and plugin development guides |
docs/assets/ |
Showcase images, pet animations and community QR codes used on this page |
tooling/ |
Toolchain, APK build and diagnostic scripts |
services/, site/, infra/ |
Companion sharing service, website and deployment materials |
Contribute
Report bugs and suggest improvements in Issues. For code, documentation and translation changes, start with CONTRIBUTING.en.md. Plugin authors can use the plugin guides and SDK.
Report security issues through SECURITY.en.md. Keep vulnerability details and credentials out of public issues.
Community
- Forum: forum.dshtui.com
- QQ group:
1132118290(join) - WeChat group: scan the code below; if it has expired, join the QQ group
QQ group 1132118290. On a computer, join with one click. The WeChat code changes every week; if it has expired, join the QQ group.
Friends' Links
- DSH-TUI: the interactive terminal UI for DeepSeek Harness by the same author — the desktop counterpart to DSH Go, with a pixel whale, live status and time travel (GitHub).
License scope and redistribution
The code is open source under AGPL-3.0, and forking it to study, self-host or build on is welcome. Please respect the original author and project origin:
- Please contact the author before making modifications. If you plan to modify this project, develop it further or publish a derivative product, please contact the original author, ccch1mneyyy, through Issues or the community in advance and describe your intended use and plans.
- Please credit the upstream repository and author in forks. When publishing a modified version, please clearly credit https://github.com/ccch1mneyyy/dsh-go and the original author, ccch1mneyyy, in the repository README, in-app About screen and release page. Retain copyright, license and modification notices as required by the applicable license.
- No unauthorized commercial reskins. Do not use this project's brand graphics or protected assets, including Deepy and Whale girl, in reskinned products for sale, paid distribution or other commercial products without permission. Do not violate the applicable license by removing required copyright and license notices or distributing derivative code without the required source, or impersonate the original author or an official release.
- The name and assets are separate. The DSH Go name and logo, and the Deepy and Whale girl mascots, are not covered by AGPL-3.0. Ship a modified build under your own name and assets; see ASSETS.md.
License clarification: AGPL-3.0 permits modification, redistribution and commercial use subject to its terms. Advance contact and the requested credit locations above are collaboration requests from the author, not additional restrictions on the code license. Brand and asset use remains subject to their own terms; this notice does not change the licenses of sdk/, examples/ or third-party content.
License and acknowledgments
This project is licensed under AGPL-3.0. sdk/ and examples/ remain MIT. Third-party code and assets retain the terms stated in their own notices.
- DeepSeek Harness: the agent DSH Go runs and connects to.
- DSH-TUI: home of the mascots, Deepy and Whale girl.
Code derived from Phase is used with the author's permission. DeepSeek Harness, PiPilot, DS Bot, DSH Remote and other third-party components and assets retain their own licenses and attribution. See THIRD_PARTY_NOTICES.md for sources and terms.
The DSH Go name, logo and mascots (Deepy and Whale girl) are not covered by the AGPL; see ASSETS.md for their terms.
Remote connections draw on the ds-harness-remote project and its server. Thanks to its author, liguobao.
DSH Go is an unofficial client made by the community. It is not affiliated with or endorsed by DeepSeek. DeepSeek names and marks belong to their owners.
Explore related projects
affaan-m/ECC
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
299,915 starsNousResearch/hermes-agent
The agent that grows with you
261,921 starsmultica-ai/andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
231,142 starsfirecrawl/firecrawl
Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥
199,847 stars