amv-diffusion 2.1.0__py3-none-any.whl

amv_diffusion-2.1.0.dist-info/METADATA

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: amv-diffusion
+Version: 2.1.0
+Summary: AmfyUI (ComfyUI Mobile DAG Studio) & Z-Image Turbo (6.0B DiT) On-Device Diffusion Runtime for Android Termux
+Home-page: https://github.com/uno-km/termux-diffusion
+Author: uno-km (AMEVA Foundation)
+Author-email: "uno-km (AMEVA Foundation)" <zhfldk014745@naver.com>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/uno-km/amv-diffusion
+Project-URL: Documentation, https://uno-km.github.io/amv-diffusion/
+Project-URL: npm Package, https://www.npmjs.com/package/amv-diffusion
+Project-URL: Bug Tracker, https://github.com/uno-km/amv-diffusion/issues
+Project-URL: Source, https://github.com/uno-km/amv-diffusion
+Keywords: stable-diffusion,diffusion,termux,android,samsung-galaxy,edge-ai,on-device-ai,image-generation,text-to-image,gguf,arm64,aarch64,neon,simd,bionic-libc,vae-tiling,galaxy-s25,galaxy-s21
+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
+Provides-Extra: gpu
+Requires-Dist: ameva-runtime>=2.0.0; extra == "gpu"
+Provides-Extra: detailer
+Requires-Dist: numpy>=1.20.0; extra == "detailer"
+Requires-Dist: Pillow>=8.0.0; extra == "detailer"
+Dynamic: author
+Dynamic: classifier
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Termux-Diffusion (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/termux-diffusion.svg?style=flat-square&color=0369a1)](https://pypi.org/project/termux-diffusion/)
+[![Python](https://img.shields.io/pypi/pyversions/termux-diffusion.svg?style=flat-square)](https://pypi.org/project/termux-diffusion/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/termux-diffusion)
+
+> **Official Z-Image Turbo (6.0B DiT) & Pure Native On-Device Diffusion Acceleration for Android Termux & Samsung Galaxy.**  
+> *Zero PRoot. Zero Virtualization. 100% Native ARM64 Bionic libc, Khronos Vulkan 1.1+ GPU Shaders & NEON SIMD Vector Engine.*
+
+---
+
+## What's New in v2.1.0 — Mobile Canva Studio & SurfaceFlinger Shield
+
+- Added Mobile Canva Studio Suite: Magic Eraser (magic_eraser), Magic Grab (magic_grab), Magic Expand (magic_expand), and Magic Layers (decompose_layers).
+- Implemented SurfaceFlinger Crash Shield with GPU duty-cycle throttling and safe-mode protection.
+- Added Safe Memory Purger with automatic OOM safety budget management.
+- Unified GPU acceleration dispatch through ameva-runtime HAL.
+
+---
+
+## 🚀 Major Breakthrough: 6.0B DiT (Z-Image Turbo) Sovereign Mobile Execution
+
+`termux-diffusion v1.8.0` introduces official production support for **Z-Image Turbo**, empowering mobile devices to execute modern **6.0 Billion Parameter Diffusion Transformers (DiT)** natively on-device.
+
+### 🌟 Tri-Engine Asymmetric Architecture
+* **Text Encoder (CPU 4-Core)**: 4.0B LLM (`Qwen3-4B-Instruct-2507-Q2_K.gguf`) performs dense context embedding on CPU Big/Prime cores (`clip_on_cpu=True`).
+* **DiT Denoising Backbone (Vulkan GPU)**: 6.0B Diffusion Transformer (`z_image_turbo-Q2_K.gguf`) accelerated via Khronos Vulkan compute shaders with Tiled Flash Attention (`diffusion_fa=True`).
+* **Ultra-Fast VAE Decoder (CPU)**: 10MB Tiny AutoEncoder for FLUX.1 (`taef1.safetensors`) completes latent decoding rapidly without memory spikes (`vae_on_cpu=True`).
+* **Layer Streaming (`stream_layers=True`)**: Breaks through mobile memory limits by streaming layers into Vulkan VRAM sequentially, maintaining a strict **1.0 GB VRAM footprint** (`max_vram="vulkan0=1"`) and completely eliminating Android Low Memory Killer (LMK) aborts.
+
+---
+
+## 📸 Sovereign Physical Verification: Galaxy S21 DiT 8-Step Output
+
+* **Verification Image**: [Galaxy S21 Z-Image Turbo 8-Step PNG Artifact](https://raw.githubusercontent.com/uno-km/termux-diffusion/main/docs/research/s21_z_image_turbo_8step.png)
+* **Verification Prompt (Ground Truth)**:
+  ```text
+  "A cinematic photo of a neon cybernetic tiger walking in Seoul street at night"
+  ```
+* **Verified Input Parameter Engineering**:
+  * `steps=8` (Full numerical convergence ODE solver)
+  * `cfg_scale=1.0` (Optimal guidance for distilled DiT architecture)
+  * `sampler="euler"` (1st-order Ordinary Differential Equation solver)
+  * `device="vulkan"` (Physical GPU acceleration)
+  * `diffusion_fa=True` (Tiled Flash Attention enabled)
+  * `stream_layers=True` (Layer residency streaming over AXI bus)
+  * `max_vram="vulkan0=1"` (Strict 1.0 GB VRAM ceiling, Zero-LMK protection)
+  * `clip_on_cpu=True` (Offloads LLM prompt embedding to CPU Big/Prime cores)
+  * `vae_on_cpu=True` (Prevents GPU VRAM allocation collisions during decoding)
+  * `taesd="auto"` (Ultra-fast 10MB FLUX.1 latent decoder)
+* **Optical Realism**: Specular light scattering from neon signboards on wet Seoul asphalt road surfaces, razor-sharp cybernetic armor plates, and micro-texture whiskers cleanly isolated from background noise.
+* **Runtime Stability**: 100% completion achieved with zero Out-of-Memory (LMK) aborts and zero thermal throttling termination.
+
+### 🔬 Academic Research & Lab Report Reference
+* **Full Technical Research Report**: [Galaxy S21 Z-Image Turbo Vulkan Research Report](https://github.com/uno-km/termux-diffusion/blob/main/docs/research/s21_z_image_turbo_vulkan_research_report.md)
+* **Academic Research Paper**: [AMEVA Labs | Sovereign On-Device AI Research, Newsletter & Discussion](https://uno-km.vercel.app/labs/index.html?menu=research-papers&post=33)
+
+---
+
+## 💻 Python SDK Installation & Practical User Manual
+
+### 1. Installation & Provisioning
+```bash
+pkg update && pkg install -y python clang termux-api
+pip install termux-diffusion
+termux-diffusion install
+```
+
+### 2. Python API Practical Code Example
+
+```python
+import termux_diffusion as td
+
+# 1. Official Z-Image Turbo 6.0B DiT Synthesis via Python API
+image_path = td.generate(
+    prompt="A cinematic photo of a neon cybernetic tiger walking in Seoul street at night",
+    preset="z-image-turbo",
+    steps=8,
+    cfg_scale=1.0,
+    sampler="euler",
+    device="vulkan",
+    diffusion_fa=True,
+    stream_layers=True,
+    max_vram="vulkan0=1",
+    clip_on_cpu=True,
+    vae_on_cpu=True,
+    taesd="auto",
+    output_path="/sdcard/Pictures/TermuxDiffusion/cyber_tiger_dit.png"
+)
+print(f"Generated via 6.0B DiT Tri-Engine: {image_path}")
+
+# 2. Fast UNet Standard Inference (DreamShaper 8 LCM 6-Step)
+lcm_path = td.generate(
+    prompt="A cinematic photo of a neon cybernetic tiger walking in Seoul street at night",
+    model="anime",
+    steps=6,
+    cfg_scale=1.5,
+    sampler="lcm",
+    device="vulkan",
+    diffusion_fa=True,
+    vae_on_cpu=True,
+    output_path="/sdcard/Pictures/TermuxDiffusion/cyber_tiger_lcm.png"
+)
+print(f"Generated via DreamShaper 8 LCM: {lcm_path}")
+```
+
+---
+
+## 🎛️ Python API Parameter Reference
+
+| Argument | Type | Default | Engineering Purpose |
+| :--- | :---: | :---: | :--- |
+| `prompt` | `str` | *Required* | Text conditioning prompt |
+| `width`, `height` | `int` | `512` | Image dimensions (multiples of 64) |
+| `steps` | `int` | `8` (DiT) / `6` (LCM) | Numerical solver sampling iterations |
+| `cfg_scale` | `float` | `1.0` (DiT) / `1.5` (LCM) | Classifier-Free Guidance scale weight |
+| `sampler` | `str` | `"euler"` | Denoising ODE solver algorithm |
+| `device` | `str` | `"vulkan"` | Accelerator device (`"vulkan"`, `"cpu"`) |
+| `preset` | `str` | `"z-image-turbo"` | Verified configuration bundle |
+| `stream_layers` | `bool` | `True` (DiT) | Enables dynamic layer streaming over AXI bus |
+| `max_vram` | `str` | `"vulkan0=1"` | GPU memory ceiling (1.0 GB) to avert OS LMK aborts |
+| `diffusion_fa` | `bool` | `True` | Flash Attention $O(N)$ memory reduction |
+| `clip_on_cpu` | `bool` | `True` | Keeps LLM text encoder on CPU cores |
+| `vae_on_cpu` | `bool` | `True` | Offloads VAE decode from GPU to host CPU |
+| `taesd` | `str` | `"auto"` | Tiny AutoEncoder for ultra-fast latent decoding |
+| `output_path` | `str` | `None` | Path to save output PNG artifact |
+
+---
+
+## 🌐 Official Documentation & Ecosystem Links
+- [Official Architecture & API Reference](https://uno-km.vercel.app/lib/diffusion/)
+- [Advanced Parameters Handbook](https://uno-km.vercel.app/lib/diffusion/advanced-parameters.html)
+- [GitHub Repository](https://github.com/uno-km/termux-diffusion)
+- [AMEVA Open-Source Foundation Portal](https://uno-km.vercel.app/foundation/index.html)
+
+---
+
+## 📄 License
+Licensed under the Apache-2.0 License. Copyright (c) 2026 Eunho Kim ([@uno-km](https://github.com/uno-km)).

amv_diffusion-2.1.0.dist-info/RECORD

@@ -0,0 +1,39 @@
+amv_diffusion-2.1.0.dist-info/licenses/LICENSE,sha256=Ek5JuH4HK-oMetVBul6Ovr7D6MVfNkPrSOpWqIwiCXI,1084
+termux_diffusion/__init__.py,sha256=Mi7sU2hWIr5YjU4ShrpDn5rV6ogAsZy1q1YtlWAGLUE,4257
+termux_diffusion/__main__.py,sha256=GFSyexSImJRDii6yUnHJ4DI6LqcxLhIGV4d7Du-1yrM,228
+termux_diffusion/_version.py,sha256=h7xNDxf8Vj0mFraELKc1VxOmhsJwgL9DS3M8Ozdpg0o,152
+termux_diffusion/adapter.py,sha256=xTQU4FKUZq-ETyD5A-QVVwz4NJYmIhI3ywgOeR7LEPQ,1615
+termux_diffusion/canvas.py,sha256=8Ys6H5VFd5bOASEyFQUlTDwpqVuyPQYbw9gZxfrfhQ4,13199
+termux_diffusion/cli.py,sha256=oTP82qYlVEdRmqohvRR3W17cW8xkwOY8Tpw_qPmVjWU,30431
+termux_diffusion/cluster.py,sha256=4_3X4nBGEriWNY6qymTEQufqy_CH7Br5TvbpYPrUONg,13328
+termux_diffusion/core.py,sha256=BBUhuKAGrxe4Ts73n81P5jbPMbdN4Toc56r-MSWMJMI,68219
+termux_diffusion/detailer.py,sha256=iutpwxAS7rwAl9Vmr1LSZpxP0jQRcVWzMPNHawxz_Pw,11512
+termux_diffusion/doctor.py,sha256=lgleva4aOiXgJjZgIgPwPTIeCD_fLkD3kxqfmsdhv9Q,5695
+termux_diffusion/downloader.py,sha256=ek4q0D0BRyfn4wlxEcE9klITZAmFKOwA_daS0W9RGQU,4219
+termux_diffusion/engine.py,sha256=8BwAylT3Ye2pqXnSF8ANhUqmkfpEqTHrbytyLICDNvo,9587
+termux_diffusion/exceptions.py,sha256=H5KWcpVBG64CRpyb7YW-BS1Mir5HB_HgnXYThoYyBBU,5397
+termux_diffusion/hardware.py,sha256=1nm7Z5DuInSE3_8aaOy5mfoP2QmBOScde-YhQE1mkis,39433
+termux_diffusion/hub.py,sha256=nLWidiOpScCsaFPCZG_o0qu8vgwKVYKAXQh05bkFBho,27290
+termux_diffusion/installer.py,sha256=xqy8AQhVkKdR6GJsPFvx-j4BX0VfwZQEIoVufVjVo6g,20969
+termux_diffusion/locking.py,sha256=W4PBMdU8cpR7PIa5LBJ3mQs71vcfOz55POtz4B7mPGs,5549
+termux_diffusion/manifest.py,sha256=pGcgi1eIolqSNfMLNu_zrVBwpIIbzCGA9aTYC57H43A,4025
+termux_diffusion/npu.py,sha256=bAAgJ4mBJHfP3pSVoxgLh8i7MP02Am-ZNUQlyMm4668,10928
+termux_diffusion/platform.py,sha256=-hakFuhtz-JdCOe9E-sEQOUcti9lILylgHes7SL60h8,22544
+termux_diffusion/purger.py,sha256=VY-aAv90PmaR0X8_o8eXIJS3WHeO0zEeCeKL26ooY64,4653
+termux_diffusion/py.typed,sha256=bWew9mHgMy8LqMu7RuqQXFXLBxh2CRx0dUbSx-3wE48,27
+termux_diffusion/safety.py,sha256=1rlDAIMOBbZfBeh8Visoz_0hiSIr58xsqvw60VSS4ds,5512
+termux_diffusion/selftest.py,sha256=ljEfI79w6wBhom8RqZZfWDUSTW-d3Jio2qHfTDnVemU,7228
+termux_diffusion/web.py,sha256=NiWfZEfGgPGH31D4jiLnbmko3XELpkjzZ7cqJdWz8I8,130958
+termux_diffusion/workflow.py,sha256=nnYHxSssVwSlGmhUFMJ8nqK-WgLK8YyxSMGMoZMeOMA,57090
+termux_diffusion/control/__init__.py,sha256=TB0Lt7rhWZ6caZdoRGsdAGeI9IRSHg_gHCrp8xjlFzM,265
+termux_diffusion/control/component.py,sha256=BRgyeH-Qa6yFW5v4Qf9F0925GgeCEluhyswuTRC4BkQ,13708
+termux_diffusion/control/status.py,sha256=U8ClYQW6xYbJ6lH9JXzPAt15GTHrGOOe_7b2H2Y3jt4,575
+termux_diffusion/data/bootstrap-manifest.json,sha256=J3mSo5xXr9r-r4MbN30KnYSO9hDW_-NyCzUmVwgmyV4,333
+termux_diffusion/data/release-public-keys.json,sha256=7gOQmHV31g8RZ8wI53Y4_g5Ir8voygS9s4smrwW6HwM,224
+termux_diffusion/data/validated-vulkan-profiles.json,sha256=N4-pDOZJrf8ByulBxRRnIhQW5HWy7-yXTAxAppwi98E,8316
+termux_diffusion/data/prompt_cache/108a7149c4e70550.json,sha256=RtddBDcEBihHBMzIFDZbSwaUdYM4K7Sb9VKZD-QWi1U,359
+amv_diffusion-2.1.0.dist-info/METADATA,sha256=JnTnPXq2CLxFSVYbmISvFeG-5slvku7cWOQXptdk9aY,9115
+amv_diffusion-2.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+amv_diffusion-2.1.0.dist-info/entry_points.txt,sha256=ZuDSyLzY3-7KMPLddrp72cjvBOeF49Cyx9cYt2Z4N9o,256
+amv_diffusion-2.1.0.dist-info/top_level.txt,sha256=3rMTnjMa0GVaZgixdY5fn-Drj3LkxJ-jQW3KjzkWodA,17
+amv_diffusion-2.1.0.dist-info/RECORD,,

amv_diffusion-2.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

amv_diffusion-2.1.0.dist-info/entry_points.txt

@@ -0,0 +1,7 @@
+[ameva.components]
+amv-diffusion = termux_diffusion.adapter:create_adapter
+
+[console_scripts]
+amv-diffusion = termux_diffusion.cli:main
+amv-diffusion-doctor = termux_diffusion.cli:run_doctor_cli
+amv-diffusion-install = termux_diffusion.cli:run_install_cli

amv_diffusion-2.1.0.dist-info/licenses/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.

amv_diffusion-2.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+termux_diffusion

termux_diffusion/__init__.py

@@ -0,0 +1,185 @@
+# Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+from ._version import __version__
+
+from .core import (
+    GenerationResult,
+    ProgressInfo,
+    async_generate,
+    generate,
+    generate_stream,
+    get_default_negative_prompt,
+    get_quality_guard_negative_prompt,
+    set_default_negative_prompt,
+    resolve_vram_and_streaming_policy,
+)
+from .workflow import (
+    DAGEngine,
+    NODE_REGISTRY,
+    WorkflowError,
+    WorkflowExecutor,
+    WorkflowFormatError,
+    WorkflowParser,
+    execute_workflow,
+)
+from .web import (
+    DiffusionWebServer,
+    run_web_server,
+)
+from .exceptions import (
+    AmevaTermuxError,
+    InferenceTimeoutError,
+    ModelDownloadError,
+    ModelNotFoundError,
+    OOMRiskError,
+    PlatformNotSupportedError,
+    ProvisioningError,
+    TermuxDiffusionError,
+)
+
+from .hub import (
+    DEFAULT_PRESETS,
+    clear_cache,
+    download_model,
+    get_cache_dir,
+    get_device_model_catalog,
+    is_model_cached,
+    list_cached_models,
+    list_presets,
+    register_model,
+    resolve_model_path,
+    set_cache_dir,
+)
+from .engine import (
+    DiffusionEngine,
+    DiffusionRuntime,
+    get_binary_path,
+    locate_sd_cli,
+    load,
+)
+from .doctor import run_doctor
+from .installer import provision_engine
+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,
+)
+from .hardware import (
+    ComputeBackend,
+    HardwareProfile,
+    TermuxExecutionGuard,
+    detect_hardware_profile,
+    detect_hardware,
+    format_hardware_report,
+    get_kernel_physical_memory_gb,
+    resolve_device_backend,
+    resolve_device,
+)
+from .downloader import list_models
+
+from .npu import (
+    NPUProfile,
+    NPUVendor,
+    detect_npu_capabilities,
+    get_optimal_heterogeneous_pipeline,
+)
+from .purger import purge_idle_processes, PurgeSummary
+from .safety import (
+    evaluate_safe_memory_budget,
+    SafeMemoryAssessment,
+    save_latent_checkpoint,
+    load_latent_checkpoint,
+)
+from .canvas import (
+    magic_eraser,
+    magic_grab,
+    magic_expand,
+    decompose_layers,
+    CanvasProfilingResult,
+)
+
+__author__ = "uno-km (AMEVA Foundation)"
+__license__ = "MIT"
+
+__all__ = [
+    "__version__",
+    "generate",
+    "generate_stream",
+    "async_generate",
+    "GenerationResult",
+    "ProgressInfo",
+    "download_model",
+    "resolve_model_path",
+    "register_model",
+    "set_cache_dir",
+    "get_cache_dir",
+    "is_model_cached",
+    "list_cached_models",
+    "get_device_model_catalog",
+    "clear_cache",
+    "list_presets",
+    "DEFAULT_PRESETS",
+    "DiffusionEngine",
+    "DiffusionRuntime",
+    "load",
+    "get_binary_path",
+    "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",
+    "TermuxExecutionGuard",
+    "get_kernel_physical_memory_gb",
+    "resolve_vram_and_streaming_policy",
+    "HardwareProfile",
+    "detect_hardware",
+    "resolve_device",
+    "list_models",
+    "AmevaTermuxError",
+    "TermuxDiffusionError",
+    "PlatformNotSupportedError",
+    "ModelNotFoundError",
+    "ModelDownloadError",
+    "ProvisioningError",
+    "OOMRiskError",
+    "purge_idle_processes",
+    "PurgeSummary",
+    "evaluate_safe_memory_budget",
+    "SafeMemoryAssessment",
+    "save_latent_checkpoint",
+    "load_latent_checkpoint",
+    "magic_eraser",
+    "magic_grab",
+    "magic_expand",
+    "decompose_layers",
+    "CanvasProfilingResult",
+    "execute_workflow",
+    "WorkflowExecutor",
+    "WorkflowParser",
+    "DAGEngine",
+    "NODE_REGISTRY",
+    "WorkflowError",
+    "WorkflowFormatError",
+]
+
+
+_LAZY_DETAILER = ("detect_faces_on_image", "refine_face_regions")
+
+
+def __getattr__(name):
+    """Face refinement needs numpy and Pillow; load it only when it is used (PEP 562)."""
+    if name in _LAZY_DETAILER:
+        from . import detailer
+        return getattr(detailer, name)
+    raise AttributeError("module %r has no attribute %r" % (__name__, name))

termux_diffusion/__main__.py

@@ -0,0 +1,7 @@
+# Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+import sys
+from termux_diffusion.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

termux_diffusion/_version.py

@@ -0,0 +1,3 @@
+# Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+__version__ = "2.1.0"

termux_diffusion/adapter.py

@@ -0,0 +1,41 @@
+# Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+"""
+termux_diffusion.adapter
+=========================
+AMEVA Component Protocol v1 — Orchestrator Adapter (v0.8.1 호환)
+"""
+from __future__ import annotations
+
+from typing import Any, AsyncIterator
+
+from ameva_component.adapter_base import BaseOrchestratorAdapter
+from ameva_component.exceptions import OperationNotSupported
+from termux_diffusion.control.component import DiffusionControl
+
+
+class DiffusionOrchestratorAdapter(BaseOrchestratorAdapter):
+    """Diffusion Orchestrator Adapter.
+
+    이미지 생성은 sd-cli subprocess를 통해 수행됩니다.
+    infer()는 OPERATION_NOT_SUPPORTED — generate() REST endpoint를 사용하십시오.
+    """
+
+    COMPONENT_ID = "termux-diffusion"
+
+    def __init__(self, control: DiffusionControl | None = None) -> None:
+        self._control = control or DiffusionControl()
+
+    async def infer(self, request: dict[str, Any]) -> AsyncIterator[dict[str, Any]]:
+        """Diffusion generation은 REST endpoint /generate 를 통해 수행됩니다.
+        Orchestrator 직접 streaming은 미지원 — OperationNotSupported를 발생시킵니다.
+
+        P0-2: yield 방식은 상위 소비자가 Frame을 정상으로 처리할 위험이 있어 raise로 변경.
+        """
+        raise OperationNotSupported(operation="infer", component_id=self.COMPONENT_ID)
+        yield  # type: ignore[misc]
+
+
+def create_adapter() -> DiffusionOrchestratorAdapter:
+    """Entry Point Factory."""
+    return DiffusionOrchestratorAdapter()