Turn any Android smartphone into a complete software engineering, networking, and automation workstation using unprivileged Linux & Autonomous AI Agents.
-emerald?style=for-the-badge){kind=icon}
This entire repository—every markdown guide, architecture diagram, bootstrap script, and Git commit—was conceptualized, researched, coded, and published to GitHub 100% from an Android smartphone paired with an autonomous AI coding agent without writing a single line of manual code.
For decades, software development has been gatekept by expensive hardware:
- $2,000+ laptops with 32GB RAM.
- Battery-draining IDEs and bloated Gradle daemons.
- Complex cloud build pipelines with continuous internet dependencies.
Meanwhile, billions of people—especially students, young creators, and developers in emerging regions—carry octa-core 64-bit ARM processors with 8GB to 12GB of RAM in their pockets every day.
PocketDev is the open-source blueprint to unlock that raw power.
flowchart TD
Phone["Android Smartphone\n(64-bit Octa-Core ARM64)"] --> Termux["Termux Environment\n(F-Droid)"]
Termux --> PRoot["PRoot-Distro Container\n(Ubuntu 26.04 aarch64 • No Root)"]
PRoot --> Toolchain["Native ARM64 Toolchain\n(Python, Node.js, OpenJDK, Git, GCC)"]
PRoot --> AIAgent["Autonomous AI Coding Agent\n(Antigravity CLI / Gemini / Aider)"]
AIAgent --> Workflows["What You Can Build in Your Pocket:"]
Workflows --> W1["🌐 Full-Stack Web Apps & PWAs\n(Offline SQLite / IndexedDB)"]
Workflows --> W2["📦 Native Android APKs\n(Zero-Gradle Dalvik Compiling)"]
Workflows --> W3["📶 Wi-Fi & Network Auditing\n(nmap, scapy, packet inspection)"]
Workflows --> W4["🤖 24/7 Automation & IoT\n(Cron jobs, Telegram bots, MQTT)"]
Workflows --> W5["🖥️ Optional Laptop Pairing\n(VS Code Remote SSH / Wi-Fi View)"]
You can set up your entire Linux development workstation on Android in one step:
# 1. Install Termux from F-Droid (NOT Google Play Store!)
# 2. Open Termux and run our 1-tap bootstrap script:
curl -fsSL https://raw.githubusercontent.com/dahalsandesh/pocket-developer/master/setup.sh | bashOr follow the manual step-by-step instructions in docs/01-linux-foundation.md.
| Module | Title | Description |
|---|---|---|
| 01 | Linux Foundation | Termux installation, PRoot Ubuntu 26.04 container, package management, and storage rules. |
| 02 | The AI Agent Layer | How autonomous terminal AI agents solve the touchscreen typing bottleneck. |
| 03 | Zero-Gradle APK Compilation | Building native Android APKs in ~10 seconds with javac, dx, aapt, and apksigner. |
| 04 | Networking, Wi-Fi & Home Lab | Wi-Fi network auditing, home lab automation, SSH bastions, and headless bots. |
| 05 | Hardware Limits & Optimization | Managing RAM, swap, thermal throttling, and avoiding Android battery killers. |
| 06 | Living Proof Showcase | Deep dive into real-world projects built entirely on mobile (featuring Sangalo 🇳🇵). |
This repository includes battle-tested starter projects and templates you can drop directly into your work:
examples/hello-pocket/: Self-contained runnable minimal Android APK project with dark-mode dashboard and native JavaScript bridge. Runbash build.shto compile your first APK in 5 seconds!setup.sh: Smart dual-mode bootstrap script (provisions Termux environment on host, or installs complete Android toolchain inside Ubuntu PRoot).templates/build_apk.sh: Complete 5-step native Android APK compiler pipeline requiring zero Gradle or Android Studio.templates/server.py: Multi-threaded local Python development server configured for mobile LAN testing.
Need proof of what a smartphone paired with an AI agent can build? Look no further than सँगालो (Sangalo):
- What it is: A 100% offline, privacy-first everyday digital companion for Nepali households.
- Key Features Built on Mobile:
- 91-year authentic Bikram Sambat (BS 2000–2090) dual calendar verified against national astronomical standards.
- Native Android status bar pinned date that auto-updates at midnight (
00:00:00) viaAlarmManager. - Custom medicine routine alarms with audio ringtones, vibration, and snooze adherence tracking.
- Interactive physics pet companion (Puku) with drag momentum, backflips, and tennis ball fetch mini-game.
- Offline encrypted document vault and 5x5 strategic Bagh-Chal board game.
- Build Stats: Compiled directly on a Xiaomi Redmi Note 15 Pro 5G into a ~216 KB signed APK in 10 seconds!
Sandesh Dahal
- 🌐 Website: dahalsandesh.com.np
- 🐙 GitHub: @dahalsandesh
- 📦 Flagship Project: Sangalo
We welcome contributions from developers worldwide!
- Read our
CONTRIBUTING.mdguide for pull request standards. - Submit a pull request to add your project to
docs/06-showcase.md. - Help optimize scripts or port tools for other PRoot distributions (Debian, Alpine, Arch).
This project is licensed under the MIT License — see the LICENSE file for details.
The Pocket Developer — Freeing software creation from the desk. Built on mobile for mobile. 📱🚀