📱 CodePocket 口袋码

A truly offline Python IDE for Android — a modern coding environment on your phone, install and run.

A natively cross-compiled CPython 3.13 (with C-extension stdlib modules) is bundled inside the APK. Zero downloads, zero network, zero ads, zero subscriptions.

Download APK · Website · Gitee Mirror

Keep your IDE in your pocket — code offline, anywhere.

---

✨ Why CodePocket

	Termux	Pydroid 3	Acode	Spck	CodePocket
Offline after install	⚠️ extra setup	⚠️ partial	❌ needs network	❌ needs network	✅ runtime bundled
Modern IDE UI	❌ terminal only	⚠️ dated	✅	✅	✅
Multi-file tabs / find & replace	❌	✅	✅	✅	✅
Offline Git	✅	❌	✅	✅	✅ JGit
Native performance	✅	✅	—	—	✅ native ARM64
AI assistant (BYOK)	❌	❌	✅ cloud	✅ cloud	✅ custom endpoint
Open source & ad-free	✅ GPL	❌ paid	⚠️ ads	⚠️ IAP	✅ Apache-2.0

Our positioning: open source + ad-free + offline after install + native performance.

---

📸 Screenshots & Demo

Onboarding	Running	Output

Git	AI Assistant	Command Palette

Demo Video

▶ Download demo video · 24s · 0.6MB · no audio

---

🏗 Architecture

┌─────────────────────────────────────────────┐
│  Compose UI layer                            │
│  file tree · editor (Sora) · output · cmd    │
└──────────────────┬──────────────────────────┘
                   │ JNI (jobject callbacks)
┌──────────────────▼──────────────────────────┐
│  NativeEngine (Kotlin) + pybridge.c (JNI)    │
│  CPython 3.13 cross-compiled to arm64        │
│  streaming stdout/stderr · timeout · stdin   │
└──────────────────┬──────────────────────────┘
                   │ dlopen + sys.path
┌──────────────────▼──────────────────────────┐
│  jniLibs/arm64-v8a (bundled in APK)         │
│  libpython3.13.so · libpybridge.so · C ext   │
│  assets/python-stdlib.zip (pure-Python std)  │
└─────────────────────────────────────────────┘

Core trade-off: no custom terminal emulator, no external native toolchain dependency. CPython 3.13 is cross-compiled with the NDK into a native arm64 library and shipped inside the APK — offline after install. Only the Python runtime is integrated for now; Java (JVM) is not yet integrated (editing/highlighting only).

---

🎯 Features

Write code

• Multi-file tabs · file tree (new / rename / delete, long-press actions)
• Sora Editor code editor + 18-language TextMate syntax highlighting
• Static completion: Python keywords / builtins + symbols from the current file (zero process overhead)
• Find & replace (count & jump) · global search (cross-file)
• 26-key symbol bar · pinch-to-zoom font size · auto bracket closing · soft wrap · line number toggle
• 6 editor themes (Darcula / Monokai / Tomorrow Night Blue / Solarized…)

Run code

• Native CPython 3.13 (arm64), full stdlib (pure-Python part + C extensions)
• math / json / random / datetime / socket / ssl / sqlite3 / ctypes and more C extensions bundled
• Streaming output · input() interaction · arrow-key / Tab soft keyboard
• Infinite-loop protection (timeout interrupt) · foreground service keep-alive
• Friendly error translations (20+ common errors)
• Run configuration (command-line args) · standard script attributes like __file__

Manage projects

• Multi-project switching (long-press to delete) · 4 Python templates
• JGit Git integration: init / commit / push / pull, pure Java, offline
• SAF import/export (no storage permission needed)
• Offline package management: inspect built-in modules / import local .whl

See results

• Markdown / HTML split-pane live preview, debounced refresh
• Open HTML files in external browser
• Output panel: draggable height / copy all / share
• 3-mode theme (follow system / light / dark)

Be productive

• Command palette ⌘K: search every action + code snippets
• AI assistant (BYOK, OpenAI-compatible endpoint): explain files / fix errors / generate tests
• Session restore: return to your last editing session on restart
• Crash logs written to private storage, offline-friendly feedback

---

🚀 Quick Start

# 1) Prerequisites: JDK 17+, Android SDK (platforms;android-35, build-tools;34.0.0)
#    local.properties: sdk.dir=/path/to/android-sdk

# 2) Build the APK directly after cloning
./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk

# 3) Open the app → create a project → write code → tap ▶ Run

The native runtime (libpython3.13.so + C extensions + pure-Python stdlib zip, ~100MB) is already in the repo, so the app runs fully offline after build.

Rebuilding libpybridge.so requires the NDK 27.3 toolchain and a CPython 3.13 cross-compile environment — see scripts/package_native.sh. Not needed for daily builds: prebuilt artifacts are already in app/src/main/jniLibs/.

assets/python-stdlib.zip must keep noCompress enabled (already configured); otherwise AAPT compression breaks CPython's stdlib loading.

---

📦 Bundled Runtime

• Pure-Python stdlib: assets/python-stdlib.zip (extracted to the app's private dir, then added to sys.path)
• C extension modules: math, json, _random, _datetime, _socket, _ssl, _sqlite3, _ctypes, zlib, binascii etc. (jniLibs/arm64-v8a)
• numpy / pandas / matplotlib / pillow are NOT preinstalled — import numpy shows a missing-module hint. Offline installation of third-party wheels is planned for a later release.

---

📚 Documentation

Doc	About	Language
Branding	Naming, positioning, slogan, visual guidelines	中文
Introduction	One-page project intro for website / promotion	中文
User Guide	Install, UI, run, Git, AI — full manual	中文
Architecture	Engine, JNI bridge, threading model, layout	中文
Roadmap	Done / in progress / planned	中文
Promotion Pack	Store description, release notes, social copy	中文
FAQ	Frequently asked questions	中文
Contributing	How to get involved	English
Code of Conduct	Contributor Covenant	English
Security	Vulnerability reporting	English

---

🧭 Capability Boundaries (honest notes)

Capability	Status
Python runtime	✅ Full (native CPython 3.13, arm64)
Java runtime	❌ JVM not yet integrated (editing/highlighting only)
Performance	✅ Native execution, no WASM sandbox overhead
Sci-stack libraries	⚠️ numpy/pandas/matplotlib not preinstalled; offline import planned
pip online install	❌ Offline-first; extra libraries via manual wheel import

---

🤝 Contributing

All contributions are welcome: file issues, improve docs, fix bugs, add features.

Run python3 tools/selfcheck.py before submitting (0 errors), see CONTRIBUTING.md.

---

📄 License

Apache License 2.0 · third-party component notices in NOTICE.md

---

CodePocket「口袋码」— keep your IDE in your pocket, code offline anywhere.