Termux-Diffusion (Python)

Pure CPU Native On-Device Stable Diffusion Runtime for Android Termux & Samsung Galaxy.
Zero PRoot. Zero Virtualization. 100% Native ARM64 Bionic libc & NEON SIMD Vector Acceleration.

Installation & Native Engine Provisioning

# 1. Install Python package from PyPI
pip install termux-diffusion

# 2. Provision prebuilt Pure CPU native engine & OpenMP runtime
termux-diffusion install

Quickstart (Python SDK)

import termux_diffusion as td

# Generate image using pure CPU with LCM anime preset
image_path = td.generate(
    prompt="cute polar bear in snow, high quality illustration",
    model="anime",
    steps=6,
    device="cpu",
    output_path="polar_bear.png"
)
print(f"Generated and saved to Android Gallery: {image_path}")

CLI Usage

termux-diffusion generate "cute dolphin, vibrant ocean" -m anime --cpu -o dolphin.png

Key Capabilities

ARMv8.2-A DotProd & FP16 NEON SIMD: Native matrix acceleration compiled directly against Android Bionic libc.
Built-in VAE Tiling: Reduces peak RAM consumption by ~70% during latent-to-pixel decoding to prevent Out-Of-Memory (OOM) aborts.
Android MediaStore Auto-Indexing: Automatically synchronizes generated images into Pictures/TermuxDiffusion and the native Samsung Gallery.
Fail-Fast Protection: Blocks unintended on-device compilation cycles to protect mobile devices from severe thermal throttling.

Hardware Benchmarks (Physical Android Devices)

Device	AP / Architecture	Wall Time	Sampling Time	Peak RAM
Galaxy S25	Snapdragon 8 Elite	15m 52s (951s)	11m 37s (697s)	~2.5 GB
Galaxy S21	Exynos 2100	53m 45s (3221s)	7m 47s (467s)	~2.4 GB

Documentation & Repository

License

Metadata

Release files for termux-diffusion 1.6.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for termux-diffusion 1.6.6
File	Size	Uploaded
termux_diffusion-1.6.6.tar.gz	69.5 kB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for termux-diffusion 1.6.6
File	Interpreter	ABI	Platform	Reset
termux_diffusion-1.6.6-py3-none-any.whl 65.0 kB Sep 18, 2026	Python 3	none	any	Details

Total release size: 134.5 kB

Release files / termux_diffusion-1.6.6.tar.gz

Download URL	termux_diffusion-1.6.6.tar.gz
Size	69.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`ce68b7dc698fd43c7e67993dd63ab4129dccd6e483580a3b5bfca7eb912edde5`
BLAKE2b-256 checksum How to use checksums	`80a92892cdff8f144cb42ee3baced50289863653a5b6065b9041f6a61d1bfcdd`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.16`

Release files / termux_diffusion-1.6.6-py3-none-any.whl

Download URL	termux_diffusion-1.6.6-py3-none-any.whl
Size	65.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d3a29098b5bd6df4cbec1de800a5a21ff5ad59851ae021e0aeac7494e88f3092`
BLAKE2b-256 checksum How to use checksums	`bb06dc6ce93649570219ab5d4d602e6774961e66487e969bae1388cb1dc93242`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.16`