termux-diffusion 1.0.0__tar.gz

termux_diffusion-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 uno-km (쌩초보코딩단)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

termux_diffusion-1.0.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.1
+Name: termux-diffusion
+Version: 1.0.0
+Summary: Production On-Device AI Image Generation Framework for Android Termux & Samsung Galaxy (Dual-Engine Python & Node.js)
+Home-page: https://github.com/uno-km/termux-diffusion
+Author: uno-km (쌩초보코딩단)
+Author-email: "uno-km (쌩초보코딩단)" <hosequelbo@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/uno-km/termux-diffusion
+Project-URL: Documentation, https://uno-km.github.io/termux-diffusion/
+Project-URL: npm Package, https://www.npmjs.com/package/termux-diffusion
+Project-URL: Bug Tracker, https://github.com/uno-km/termux-diffusion/issues
+Project-URL: Source, https://github.com/uno-km/termux-diffusion
+Keywords: stable-diffusion,diffusion,termux,android,samsung-galaxy,edge-ai,on-device-ai,image-generation,gguf,arm64,bionic-libc,snapdragon,exynos,text-to-image,txt2img,mobile-ai,quantization,generative-ai,vulkan,opencl,offline-ai,private-ai,ai-art,comfyui-alternative,webui-alternative
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Android
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Termux-Diffusion
+
+**Production On-Device AI Image Generation Framework for Android Termux & Samsung Galaxy**  
+*Dual-Engine Architecture (Python & Node.js / TypeScript) with Native Bionic ARM64 Tensor Acceleration*
+
+[![PyPI Version](https://img.shields.io/pypi/v/termux-diffusion.svg?color=blue)](https://pypi.org/project/termux-diffusion/)
+[![npm Version](https://img.shields.io/npm/v/termux-diffusion.svg?color=red)](https://www.npmjs.com/package/termux-diffusion)
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://pypi.org/project/termux-diffusion/)
+[![Node Version](https://img.shields.io/badge/node-16+-brightgreen.svg)](https://www.npmjs.com/package/termux-diffusion)
+[![Platform](https://img.shields.io/badge/platform-Android%20Termux%20(ARM64)-green.svg)](https://github.com/uno-km/termux-diffusion)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+---
+
+## 1. System Overview
+
+`termux-diffusion` is an enterprise-grade, on-device AI text-to-image synthesis pipeline designed specifically for Android Termux environments and Samsung Galaxy hardware.
+
+Unlike desktop-centric WebUI ports that require heavy containerization (e.g., PRoot Linux / Ubuntu) or suffer from memory exhaustion under the Android Low Memory Killer (LMK), `termux-diffusion` executes directly against native Android Bionic `libc` with ARM64 NEON SIMD vectorization and GGML quantized tensor weights.
+
+---
+
+## 2. Automated Bootstrap & Installation
+
+### Option A: One-Line Zero-Touch Bootstrap (Recommended)
+
+Run the platform bootstrap script in Termux to automatically verify toolchains, storage permissions, and native engine binaries:
+
+#### Python Runtime
+```bash
+curl -sL https://raw.githubusercontent.com/uno-km/termux-diffusion/main/docs/install.sh | bash
+```
+
+#### Node.js / TypeScript Runtime
+```bash
+curl -sL https://raw.githubusercontent.com/uno-km/termux-diffusion/main/docs/install-node.sh | bash
+```
+
+---
+
+### Option B: Package Manager Installation
+
+#### Python (PyPI)
+```bash
+pip install termux-diffusion && termux-diffusion-install
+```
+
+#### Node.js (npm)
+```bash
+npm install -g termux-diffusion && npx termux-diffusion install
+```
+
+---
+
+## 3. Core Architectural Capabilities
+
+* **Zero-PRoot Native Bionic Execution:** Executes natively on ARM64 without container overhead, achieving maximum memory efficiency.
+* **Integrated Model Hub:** Built-in streaming downloader with automatic checksum verification and cache persistence.
+* **Power & WakeLock Management (`TermuxWakeLock`):** Automatically holds Android CPU WakeLock during inference, preventing kernel suspension when the screen turns off.
+* **Low-Memory & LMK Guard:** Inspects physical memory and Android zRAM (Samsung RAM Plus) before allocating tensor weight buffers.
+* **Samsung Gallery Integration:** Automatically persists generated outputs to `~/storage/pictures/TermuxDiffusion/` and triggers `android.intent.action.MEDIA_SCANNER_SCAN_FILE` for instant indexing in Samsung Gallery.
+* **big.LITTLE Core Affinity Tuning:** Auto-detects Exynos (e.g., 1380, 1480, 2400) and Snapdragon cluster topologies to maintain high sustained clock rates without thermal throttling.
+* **Hardware Compute Selection:** Explicit compute backend targeting via `device="cpu"` or `device="gpu"`.
+
+---
+
+## 4. Built-in Model Hub Presets
+
+| Preset | Model & Quantization | Size | Latency Baseline (Exynos 1380) | Recommended Workload |
+| :--- | :--- | :---: | :---: | :--- |
+| **`"realistic"`** | Realistic Vision V6.0 B1 (Q4_K) | 1.62 GB | ~25 min (10 steps) | High-fidelity photorealism (portraits, skin textures, lighting) |
+| **`"speed"`** | Stable Diffusion 1.5 Base (Q4_1) | 1.59 GB | ~15 min (10 steps) | General-purpose drafting and composition |
+| **`"sdxs"`** | SDXS 512-0.9 Mobile (Q4_0) | **450 MB** | **~2.5 min (2 steps)** | Ultra-low latency mobile prototyping |
+| **`"turbo"`** | SD Turbo (Q4_0) | 1.20 GB | ~4 min (1 step) | Single-step real-time inference |
+| **`"anime"`** | DreamShaper 8 (Q4_K) | 1.65 GB | ~20 min (10 steps) | 2D / 2.5D stylized illustration and animation art |
+
+---
+
+## 5. Usage & Integration
+
+### Python API
+
+```python
+from termux_diffusion import generate
+
+result = generate(
+    prompt="RAW photo, portrait of a happy smiling young Korean man in his 30s wearing glasses and hoodie, working on laptop, photorealistic, cinematic",
+    model="realistic",
+    device="cpu",
+    steps=10,
+    cfg_scale=4.0,
+    output="developer.png"
+)
+
+print(f"Output Path: {result.path}")
+print(f"Android MediaStore: {result.gallery_path}")
+print(f"Elapsed Time: {result.elapsed_sec:.2f}s")
+```
+
+### Node.js / TypeScript API
+
+```javascript
+const { generate } = require('termux-diffusion');
+
+async function main() {
+    const result = await generate({
+        prompt: 'cyberpunk cat with neon collar in rainy alley, 8k, photorealistic',
+        model: 'speed',
+        device: 'cpu',
+        steps: 10,
+        output: 'cyber_cat.png'
+    });
+
+    console.log(`Output Path: ${result.path}`);
+    console.log(`Android MediaStore: ${result.galleryPath}`);
+}
+
+main().catch(console.error);
+```
+
+---
+
+## 6. Custom Models & Hugging Face Resolution
+
+### 1. Direct Hugging Face Repository Identifier
+Pass any repository ID and `.gguf` filename. The framework resolves, streams, caches, and executes the weights:
+```python
+generate(
+    "1girl, anime masterpiece, vibrant colors",
+    model="second-state/DreamShaper-8-GGUF/dreamshaper-8-Q4_k.gguf"
+)
+```
+
+### 2. Local File Reference
+```python
+generate(
+    "fantasy landscape at sunrise",
+    model="~/storage/downloads/custom_model.gguf"
+)
+```
+
+### 3. Alias Registration (`register_model`)
+```python
+from termux_diffusion import register_model, generate
+
+register_model("waifu", repo_id="second-state/DreamShaper-8-GGUF", filename="dreamshaper-8-Q4_k.gguf")
+generate("anime portrait", model="waifu")
+```
+
+---
+
+## 7. Pre-flight Diagnostic Tool
+
+Verify system packages, architecture, available memory, and native engine status:
+
+```bash
+# Python
+termux-diffusion-doctor
+
+# Node.js
+npx termux-diffusion doctor
+```
+
+---
+
+## 8. License
+
+Released under the **MIT License**. Maintained by **uno-km**.

termux_diffusion-1.0.0/README.md

@@ -0,0 +1,168 @@
+# Termux-Diffusion
+
+**Production On-Device AI Image Generation Framework for Android Termux & Samsung Galaxy**  
+*Dual-Engine Architecture (Python & Node.js / TypeScript) with Native Bionic ARM64 Tensor Acceleration*
+
+[![PyPI Version](https://img.shields.io/pypi/v/termux-diffusion.svg?color=blue)](https://pypi.org/project/termux-diffusion/)
+[![npm Version](https://img.shields.io/npm/v/termux-diffusion.svg?color=red)](https://www.npmjs.com/package/termux-diffusion)
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://pypi.org/project/termux-diffusion/)
+[![Node Version](https://img.shields.io/badge/node-16+-brightgreen.svg)](https://www.npmjs.com/package/termux-diffusion)
+[![Platform](https://img.shields.io/badge/platform-Android%20Termux%20(ARM64)-green.svg)](https://github.com/uno-km/termux-diffusion)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+---
+
+## 1. System Overview
+
+`termux-diffusion` is an enterprise-grade, on-device AI text-to-image synthesis pipeline designed specifically for Android Termux environments and Samsung Galaxy hardware.
+
+Unlike desktop-centric WebUI ports that require heavy containerization (e.g., PRoot Linux / Ubuntu) or suffer from memory exhaustion under the Android Low Memory Killer (LMK), `termux-diffusion` executes directly against native Android Bionic `libc` with ARM64 NEON SIMD vectorization and GGML quantized tensor weights.
+
+---
+
+## 2. Automated Bootstrap & Installation
+
+### Option A: One-Line Zero-Touch Bootstrap (Recommended)
+
+Run the platform bootstrap script in Termux to automatically verify toolchains, storage permissions, and native engine binaries:
+
+#### Python Runtime
+```bash
+curl -sL https://raw.githubusercontent.com/uno-km/termux-diffusion/main/docs/install.sh | bash
+```
+
+#### Node.js / TypeScript Runtime
+```bash
+curl -sL https://raw.githubusercontent.com/uno-km/termux-diffusion/main/docs/install-node.sh | bash
+```
+
+---
+
+### Option B: Package Manager Installation
+
+#### Python (PyPI)
+```bash
+pip install termux-diffusion && termux-diffusion-install
+```
+
+#### Node.js (npm)
+```bash
+npm install -g termux-diffusion && npx termux-diffusion install
+```
+
+---
+
+## 3. Core Architectural Capabilities
+
+* **Zero-PRoot Native Bionic Execution:** Executes natively on ARM64 without container overhead, achieving maximum memory efficiency.
+* **Integrated Model Hub:** Built-in streaming downloader with automatic checksum verification and cache persistence.
+* **Power & WakeLock Management (`TermuxWakeLock`):** Automatically holds Android CPU WakeLock during inference, preventing kernel suspension when the screen turns off.
+* **Low-Memory & LMK Guard:** Inspects physical memory and Android zRAM (Samsung RAM Plus) before allocating tensor weight buffers.
+* **Samsung Gallery Integration:** Automatically persists generated outputs to `~/storage/pictures/TermuxDiffusion/` and triggers `android.intent.action.MEDIA_SCANNER_SCAN_FILE` for instant indexing in Samsung Gallery.
+* **big.LITTLE Core Affinity Tuning:** Auto-detects Exynos (e.g., 1380, 1480, 2400) and Snapdragon cluster topologies to maintain high sustained clock rates without thermal throttling.
+* **Hardware Compute Selection:** Explicit compute backend targeting via `device="cpu"` or `device="gpu"`.
+
+---
+
+## 4. Built-in Model Hub Presets
+
+| Preset | Model & Quantization | Size | Latency Baseline (Exynos 1380) | Recommended Workload |
+| :--- | :--- | :---: | :---: | :--- |
+| **`"realistic"`** | Realistic Vision V6.0 B1 (Q4_K) | 1.62 GB | ~25 min (10 steps) | High-fidelity photorealism (portraits, skin textures, lighting) |
+| **`"speed"`** | Stable Diffusion 1.5 Base (Q4_1) | 1.59 GB | ~15 min (10 steps) | General-purpose drafting and composition |
+| **`"sdxs"`** | SDXS 512-0.9 Mobile (Q4_0) | **450 MB** | **~2.5 min (2 steps)** | Ultra-low latency mobile prototyping |
+| **`"turbo"`** | SD Turbo (Q4_0) | 1.20 GB | ~4 min (1 step) | Single-step real-time inference |
+| **`"anime"`** | DreamShaper 8 (Q4_K) | 1.65 GB | ~20 min (10 steps) | 2D / 2.5D stylized illustration and animation art |
+
+---
+
+## 5. Usage & Integration
+
+### Python API
+
+```python
+from termux_diffusion import generate
+
+result = generate(
+    prompt="RAW photo, portrait of a happy smiling young Korean man in his 30s wearing glasses and hoodie, working on laptop, photorealistic, cinematic",
+    model="realistic",
+    device="cpu",
+    steps=10,
+    cfg_scale=4.0,
+    output="developer.png"
+)
+
+print(f"Output Path: {result.path}")
+print(f"Android MediaStore: {result.gallery_path}")
+print(f"Elapsed Time: {result.elapsed_sec:.2f}s")
+```
+
+### Node.js / TypeScript API
+
+```javascript
+const { generate } = require('termux-diffusion');
+
+async function main() {
+    const result = await generate({
+        prompt: 'cyberpunk cat with neon collar in rainy alley, 8k, photorealistic',
+        model: 'speed',
+        device: 'cpu',
+        steps: 10,
+        output: 'cyber_cat.png'
+    });
+
+    console.log(`Output Path: ${result.path}`);
+    console.log(`Android MediaStore: ${result.galleryPath}`);
+}
+
+main().catch(console.error);
+```
+
+---
+
+## 6. Custom Models & Hugging Face Resolution
+
+### 1. Direct Hugging Face Repository Identifier
+Pass any repository ID and `.gguf` filename. The framework resolves, streams, caches, and executes the weights:
+```python
+generate(
+    "1girl, anime masterpiece, vibrant colors",
+    model="second-state/DreamShaper-8-GGUF/dreamshaper-8-Q4_k.gguf"
+)
+```
+
+### 2. Local File Reference
+```python
+generate(
+    "fantasy landscape at sunrise",
+    model="~/storage/downloads/custom_model.gguf"
+)
+```
+
+### 3. Alias Registration (`register_model`)
+```python
+from termux_diffusion import register_model, generate
+
+register_model("waifu", repo_id="second-state/DreamShaper-8-GGUF", filename="dreamshaper-8-Q4_k.gguf")
+generate("anime portrait", model="waifu")
+```
+
+---
+
+## 7. Pre-flight Diagnostic Tool
+
+Verify system packages, architecture, available memory, and native engine status:
+
+```bash
+# Python
+termux-diffusion-doctor
+
+# Node.js
+npx termux-diffusion doctor
+```
+
+---
+
+## 8. License
+
+Released under the **MIT License**. Maintained by **uno-km**.

termux_diffusion-1.0.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "termux-diffusion"
+version = "1.0.0"
+description = "Production On-Device AI Image Generation Framework for Android Termux & Samsung Galaxy (Dual-Engine Python & Node.js)"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "uno-km (쌩초보코딩단)", email = "hosequelbo@gmail.com" }
+]
+keywords = [
+    "stable-diffusion",
+    "diffusion",
+    "termux",
+    "android",
+    "samsung-galaxy",
+    "edge-ai",
+    "on-device-ai",
+    "image-generation",
+    "gguf",
+    "arm64",
+    "bionic-libc",
+    "snapdragon",
+    "exynos",
+    "text-to-image",
+    "txt2img",
+    "mobile-ai",
+    "quantization",
+    "generative-ai",
+    "vulkan",
+    "opencl",
+    "offline-ai",
+    "private-ai",
+    "ai-art",
+    "comfyui-alternative",
+    "webui-alternative"
+]
+dynamic = ["classifiers"]
+
+[project.urls]
+Homepage = "https://github.com/uno-km/termux-diffusion"
+Documentation = "https://uno-km.github.io/termux-diffusion/"
+"npm Package" = "https://www.npmjs.com/package/termux-diffusion"
+"Bug Tracker" = "https://github.com/uno-km/termux-diffusion/issues"
+"Source" = "https://github.com/uno-km/termux-diffusion"
+
+[project.scripts]
+termux-diffusion = "termux_diffusion.cli:main"
+termux-diffusion-install = "termux_diffusion.cli:run_install_cli"
+termux-diffusion-doctor = "termux_diffusion.cli:run_doctor_cli"

termux_diffusion-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

termux_diffusion-1.0.0/setup.py

@@ -0,0 +1,63 @@
+import os
+from setuptools import find_packages, setup
+
+here = os.path.abspath(os.path.dirname(__file__))
+
+long_description = ""
+readme_path = os.path.join(here, "README.md")
+if os.path.exists(readme_path):
+    with open(readme_path, encoding="utf-8") as f:
+        long_description = f.read()
+
+setup(
+    name="termux-diffusion",
+    version="1.0.0",
+    description="Production On-Device AI Image Generation Framework for Android Termux & Samsung Galaxy (Dual-Engine Python & Node.js)",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="uno-km (쌩초보코딩단)",
+    author_email="hosequelbo@gmail.com",
+    url="https://github.com/uno-km/termux-diffusion",
+    project_urls={
+        "Documentation": "https://uno-km.github.io/termux-diffusion/",
+        "npm Package": "https://www.npmjs.com/package/termux-diffusion",
+        "Bug Tracker": "https://github.com/uno-km/termux-diffusion/issues",
+        "Source": "https://github.com/uno-km/termux-diffusion",
+    },
+    keywords=[
+        "stable-diffusion", "diffusion", "termux", "android", "samsung-galaxy",
+        "edge-ai", "on-device-ai", "image-generation", "gguf", "arm64",
+        "bionic-libc", "snapdragon", "exynos", "text-to-image", "txt2img",
+        "mobile-ai", "quantization", "generative-ai", "vulkan", "opencl",
+        "offline-ai", "private-ai", "ai-art", "comfyui-alternative", "webui-alternative"
+    ],
+    packages=find_packages(),
+    package_data={
+        "termux_diffusion": ["py.typed"],
+    },
+    include_package_data=True,
+    python_requires=">=3.8",
+    install_requires=[],
+    entry_points={
+        "console_scripts": [
+            "termux-diffusion = termux_diffusion.cli:main",
+            "termux-diffusion-install = termux_diffusion.cli:run_install_cli",
+            "termux-diffusion-doctor = termux_diffusion.cli:run_doctor_cli",
+        ],
+    },
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: POSIX :: Linux",
+        "Operating System :: Android",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+        "Topic :: Multimedia :: Graphics",
+    ],
+)

termux_diffusion-1.0.0/termux_diffusion/__init__.py

@@ -0,0 +1,74 @@
+"""termux-diffusion: On-Device AI Image Generation Framework for Android Termux & Samsung Galaxy."""
+
+from .core import GenerationResult, async_generate, generate
+from .exceptions import (
+    InferenceTimeoutError,
+    ModelDownloadError,
+    ModelNotFoundError,
+    OOMRiskError,
+    PlatformNotSupportedError,
+    ProvisioningError,
+    TermuxDiffusionError,
+)
+from .hub import (
+    DEFAULT_PRESETS,
+    clear_cache,
+    download_model,
+    get_cache_dir,
+    is_model_cached,
+    list_cached_models,
+    list_presets,
+    register_model,
+    resolve_model_path,
+    set_cache_dir,
+)
+from .installer import locate_sd_cli, provision_engine, run_doctor
+from .platform import (
+    TermuxWakeLock,
+    check_memory_safety,
+    export_to_android_gallery,
+    get_galaxy_gallery_dir,
+    get_memory_info,
+    get_optimal_thread_count,
+    is_android_termux,
+    is_arm64,
+)
+
+__version__ = "1.0.0"
+__author__ = "uno-km (쌩초보코딩단)"
+__license__ = "MIT"
+
+__all__ = [
+    "__version__",
+    "generate",
+    "async_generate",
+    "GenerationResult",
+    "download_model",
+    "resolve_model_path",
+    "register_model",
+    "set_cache_dir",
+    "get_cache_dir",
+    "is_model_cached",
+    "list_cached_models",
+    "clear_cache",
+    "list_presets",
+    "DEFAULT_PRESETS",
+    "locate_sd_cli",
+    "provision_engine",
+    "run_doctor",
+    "is_android_termux",
+    "is_arm64",
+    "check_memory_safety",
+    "get_memory_info",
+    "get_optimal_thread_count",
+    "get_galaxy_gallery_dir",
+    "export_to_android_gallery",
+    "TermuxWakeLock",
+    "TermuxDiffusionError",
+    "PlatformNotSupportedError",
+    "ModelNotFoundError",
+    "ModelDownloadError",
+    "ProvisioningError",
+    "OOMRiskError",
+    "InferenceTimeoutError",
+]