🐍 Anpyra · Python to Native Android

Write small Android apps in a typed Python subset, compile them directly to DEX, and build signed APKs. Anpyra is a Python-written compiler and build framework based on the PyAndroid experiments 001–008.

Status: v0.1 alpha. Android is the only implemented target. Native iOS, Windows, macOS and Linux backends are planned. Web is outside scope. Framework-specific device acceptance remains pending; the original experiments were reported successful on a phone.

🐍 Python-based builds

Build with Python 3.11+ and Python dependencies. No Java/JDK, Kotlin, Android SDK build kit, Android NDK, Android Studio, Gradle, D8, R8, AAPT2 or apksigner is required. cryptography is installed automatically for signing. Optional adb provides device installation.

⚡ Install the published package

Once this release is available on PyPI, use uv (recommended):

uv venv --python 3.12
uv pip install anpyra

Or use pip inside a virtual environment:

python -m pip install anpyra

Activate your environment, then:

anpyra doctor
anpyra init myapp --package dev.example.myapp --label "My App"
anpyra check myapp
anpyra build myapp
anpyra verify myapp/build/dev.example.myapp.apk

For checkout installation and host-specific commands, see the installation guide.

🧩 Application example

from anpyra import Activity, TextView


class MainActivity(Activity):
    def on_create(self, state):
        title = TextView(self)
        title.set_text("Hello from Anpyra!")
        self.set_content_view(title)

Anpyra parses application source on the host. Android runs the generated bytecode. The authoring classes provide editor support; they do not preview a UI on the host.

📦 Supported features and limits

• One Activity, TextView construction, text and content-view calls.
• Initialized str, int and bool locals, simple integer arithmetic and comparisons.
• Nested conditions and typed integer helper functions.
• DEX, binary manifest, signed APK and JSON report generation.
• Retained project debug identity and local APK/DEX integrity checks.

This is a restricted compiler, not general Python on Android. Layouts, callbacks, arbitrary imports, collections, reassignment, multi-module apps and release/store signing are not implemented. The lifecycle currently has a 14-register local/temporary budget. See the language guide.

📚 Documentation and contribution

User guide · Developer guide · Roadmap · Issues · Contributing

Anpyra is licensed under Apache-2.0.