ameva-runtime 2.2.2__tar.gz → 2.2.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. {ameva_runtime-2.2.2/python/ameva_runtime.egg-info → ameva_runtime-2.2.3}/PKG-INFO +34 -11
  2. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/README.md +33 -10
  3. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/README.pypi.md +33 -10
  4. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/_version.py +1 -1
  5. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3/python/ameva_runtime.egg-info}/PKG-INFO +34 -11
  6. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/LICENSE +0 -0
  7. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/MANIFEST.in +0 -0
  8. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/profiles/validated-vulkan-profiles.json +0 -0
  9. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/pyproject.toml +0 -0
  10. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/__init__.py +0 -0
  11. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/adapters/__init__.py +0 -0
  12. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/adapters/base.py +0 -0
  13. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/adapters/bitnet.py +0 -0
  14. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/adapters/diffusion.py +0 -0
  15. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/adapters/llamacpp.py +0 -0
  16. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/adapters/stt.py +0 -0
  17. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/adapters/tts.py +0 -0
  18. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/adapters/vision.py +0 -0
  19. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/cli.py +0 -0
  20. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/core.py +0 -0
  21. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/detector.py +0 -0
  22. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/doctor.py +0 -0
  23. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/exceptions.py +0 -0
  24. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/installer.py +0 -0
  25. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/platform.py +0 -0
  26. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/protocol.py +0 -0
  27. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/router.py +0 -0
  28. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/__init__.py +0 -0
  29. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/adapters/__init__.py +0 -0
  30. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/bindings.py +0 -0
  31. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/cli.py +0 -0
  32. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/core.py +0 -0
  33. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/doctor.py +0 -0
  34. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/exceptions.py +0 -0
  35. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/platform.py +0 -0
  36. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/profiles/__init__.py +0 -0
  37. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/profiles/validated-vulkan-profiles.json +0 -0
  38. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/protocol.py +0 -0
  39. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime/vulkan/py.typed +0 -0
  40. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime.egg-info/SOURCES.txt +0 -0
  41. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime.egg-info/dependency_links.txt +0 -0
  42. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime.egg-info/entry_points.txt +0 -0
  43. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime.egg-info/requires.txt +0 -0
  44. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/ameva_runtime.egg-info/top_level.txt +0 -0
  45. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/__init__.py +0 -0
  46. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/backends/__init__.py +0 -0
  47. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/backends/base.py +0 -0
  48. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/backends/diff.py +0 -0
  49. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/backends/llm.py +0 -0
  50. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/backends/stt.py +0 -0
  51. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/backends/tts.py +0 -0
  52. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/backends/vision.py +0 -0
  53. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/cli.py +0 -0
  54. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/core.py +0 -0
  55. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/exceptions.py +0 -0
  56. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/utils/__init__.py +0 -0
  57. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/utils/hardware.py +0 -0
  58. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/python/termux_train/utils/monitor.py +0 -0
  59. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/setup.cfg +0 -0
  60. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/setup.py +0 -0
  61. {ameva_runtime-2.2.2 → ameva_runtime-2.2.3}/tests/test_termux_train.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ameva-runtime
3
- Version: 2.2.2
3
+ Version: 2.2.3
4
4
  Summary: Unified Next-Gen Hardware Orchestration & AI Acceleration Runtime for Mobile & Edge
5
5
  Home-page: https://github.com/uno-km/ameva-runtime
6
6
  Author: Eunho Kim
@@ -84,21 +84,44 @@ To install with full multi-modal engine integrations (STT, TTS, LLM, Diffusion,
84
84
  pip install "ameva-runtime[all]"
85
85
  ```
86
86
 
87
- ### 1.3 1-Click Native Hardware Asset Provisioning (One-Touch Auto-Install)
88
- Provision precompiled ARM64 Bionic binaries, native compute shaders, and hardware drivers in a single command without building from source:
87
+ ### 1.3 1-Click Native Hardware Asset Provisioning & Dual-Track Compatibility
88
+ Rather than requiring users to manually compile C/C++ source trees, setup CMake/Clang toolchains, or configure OpenMP and Vulkan loaders, AMEVA-Runtime includes an automated, atomic hardware provisioner (`NativeAssetManager`):
89
+
89
90
  ```bash
90
- # Provision all modalities (Diffusion, STT, TTS, OpenMP, EGL Shim, SPIR-V Shaders)
91
+ # 1-Click Auto-Provision all 6 modalities and native hardware drivers
91
92
  ameva install --all
92
93
 
93
- # Or provision a specific modality with force overwrite
94
+ # Or alias
95
+ ameva setup
96
+
97
+ # Force overwrite existing binaries with fresh GitHub Release assets
98
+ ameva install --all --force
99
+
100
+ # Provision a single targeted modality
94
101
  ameva install --modality diffusion --force
95
102
  ```
96
- This automatically provisions and links:
97
- * **Stable Diffusion CLI (`sd-cli`)**: `~/.local/bin/sd-cli` (and legacy path `~/.cache/termux-diffusion/bin/sd-cli`)
98
- * **Whisper STT (`whisper-cli`)**: `~/.local/bin/whisper-cli` (and `$PREFIX/bin/whisper-cli`)
99
- * **Sherpa-NCNN TTS (`sherpa-ncnn-offline-tts`)**: `~/.local/bin/sherpa-ncnn-offline-tts`
100
- * **Vulkan HAL Shim & OpenMP (`libegl_shim.so`, `libomp.so`)**: `$PREFIX/lib/`
101
- * **SPIR-V Zero-Stride Bypass Shader (`matmul.spv`)**: `~/.local/share/ameva/shaders/matmul.spv`
103
+
104
+ #### Dual-Track Compatibility Architecture (Track A + Track B)
105
+ AMEVA-Runtime enforces a **Dual-Track Deployment Architecture** to ensure zero-regression interoperability between modern unified environments and existing ecosystem toolchains:
106
+
107
+ | Asset / Engine | Clean Unified Path (Track B) | Legacy Bridge / Symlink (Track A) | Engine Type & Target Modality |
108
+ | :--- | :--- | :--- | :--- |
109
+ | **`sd-cli`** (36.2 MB) | `~/.local/bin/sd-cli` | `~/.cache/termux-diffusion/bin/sd-cli` | Stable Diffusion On-Device Vulkan Engine |
110
+ | **`whisper-cli`** (3.3 MB) | `~/.local/bin/whisper-cli` | `$PREFIX/bin/whisper-cli`, `~/.local/bin/whisper-cpp` | Whisper Speech-to-Text ARM64 Engine |
111
+ | **`sherpa-ncnn-offline-tts`** (3.9 MB) | `~/.local/bin/sherpa-ncnn-offline-tts` | `~/sherpa-ncnn/build-vulkan/bin/`, `$PREFIX/bin/` | Sherpa-NCNN Vulkan Neural Speech Synthesis |
112
+ | **`libomp.so`** (1.1 MB) | `$PREFIX/lib/libomp.so` | `~/.local/lib/libomp.so` | OpenMP High-Throughput Threading Runtime |
113
+ | **`libegl_shim.so`** (8.4 KB) | `$PREFIX/lib/libegl_shim.so` | `~/.local/lib/libegl_shim.so` | Android Termux Headless EGL/GBM Driver Shim |
114
+ | **`matmul.spv`** (4.7 KB) | `~/.local/share/ameva/shaders/matmul.spv` | `$PREFIX/share/ameva/shaders/matmul.spv` | Mali/Adreno Zero-Stride Workaround SPIR-V Shader |
115
+
116
+ #### Programmatic Python Provisioning API
117
+ You can also trigger atomic asset provisioning directly within Python workflows:
118
+ ```python
119
+ from ameva_runtime import provision_native_assets
120
+
121
+ # Provision all native binaries and link compatibility bridges
122
+ results = provision_native_assets(force=False)
123
+ print("Provisioning Status:", results)
124
+ ```
102
125
 
103
126
  ### 1.4 Node.js / TypeScript SDK & CLI Installation
104
127
  Install globally or as a project dependency via `npm`:
@@ -33,21 +33,44 @@ To install with full multi-modal engine integrations (STT, TTS, LLM, Diffusion,
33
33
  pip install "ameva-runtime[all]"
34
34
  ```
35
35
 
36
- ### 1.3 1-Click Native Hardware Asset Provisioning (One-Touch Auto-Install)
37
- Provision precompiled ARM64 Bionic binaries, native compute shaders, and hardware drivers in a single command without building from source:
36
+ ### 1.3 1-Click Native Hardware Asset Provisioning & Dual-Track Compatibility
37
+ Rather than requiring users to manually compile C/C++ source trees, setup CMake/Clang toolchains, or configure OpenMP and Vulkan loaders, AMEVA-Runtime includes an automated, atomic hardware provisioner (`NativeAssetManager`):
38
+
38
39
  ```bash
39
- # Provision all modalities (Diffusion, STT, TTS, OpenMP, EGL Shim, SPIR-V Shaders)
40
+ # 1-Click Auto-Provision all 6 modalities and native hardware drivers
40
41
  ameva install --all
41
42
 
42
- # Or provision a specific modality with force overwrite
43
+ # Or alias
44
+ ameva setup
45
+
46
+ # Force overwrite existing binaries with fresh GitHub Release assets
47
+ ameva install --all --force
48
+
49
+ # Provision a single targeted modality
43
50
  ameva install --modality diffusion --force
44
51
  ```
45
- This automatically provisions and links:
46
- * **Stable Diffusion CLI (`sd-cli`)**: `~/.local/bin/sd-cli` (and legacy path `~/.cache/termux-diffusion/bin/sd-cli`)
47
- * **Whisper STT (`whisper-cli`)**: `~/.local/bin/whisper-cli` (and `$PREFIX/bin/whisper-cli`)
48
- * **Sherpa-NCNN TTS (`sherpa-ncnn-offline-tts`)**: `~/.local/bin/sherpa-ncnn-offline-tts`
49
- * **Vulkan HAL Shim & OpenMP (`libegl_shim.so`, `libomp.so`)**: `$PREFIX/lib/`
50
- * **SPIR-V Zero-Stride Bypass Shader (`matmul.spv`)**: `~/.local/share/ameva/shaders/matmul.spv`
52
+
53
+ #### Dual-Track Compatibility Architecture (Track A + Track B)
54
+ AMEVA-Runtime enforces a **Dual-Track Deployment Architecture** to ensure zero-regression interoperability between modern unified environments and existing ecosystem toolchains:
55
+
56
+ | Asset / Engine | Clean Unified Path (Track B) | Legacy Bridge / Symlink (Track A) | Engine Type & Target Modality |
57
+ | :--- | :--- | :--- | :--- |
58
+ | **`sd-cli`** (36.2 MB) | `~/.local/bin/sd-cli` | `~/.cache/termux-diffusion/bin/sd-cli` | Stable Diffusion On-Device Vulkan Engine |
59
+ | **`whisper-cli`** (3.3 MB) | `~/.local/bin/whisper-cli` | `$PREFIX/bin/whisper-cli`, `~/.local/bin/whisper-cpp` | Whisper Speech-to-Text ARM64 Engine |
60
+ | **`sherpa-ncnn-offline-tts`** (3.9 MB) | `~/.local/bin/sherpa-ncnn-offline-tts` | `~/sherpa-ncnn/build-vulkan/bin/`, `$PREFIX/bin/` | Sherpa-NCNN Vulkan Neural Speech Synthesis |
61
+ | **`libomp.so`** (1.1 MB) | `$PREFIX/lib/libomp.so` | `~/.local/lib/libomp.so` | OpenMP High-Throughput Threading Runtime |
62
+ | **`libegl_shim.so`** (8.4 KB) | `$PREFIX/lib/libegl_shim.so` | `~/.local/lib/libegl_shim.so` | Android Termux Headless EGL/GBM Driver Shim |
63
+ | **`matmul.spv`** (4.7 KB) | `~/.local/share/ameva/shaders/matmul.spv` | `$PREFIX/share/ameva/shaders/matmul.spv` | Mali/Adreno Zero-Stride Workaround SPIR-V Shader |
64
+
65
+ #### Programmatic Python Provisioning API
66
+ You can also trigger atomic asset provisioning directly within Python workflows:
67
+ ```python
68
+ from ameva_runtime import provision_native_assets
69
+
70
+ # Provision all native binaries and link compatibility bridges
71
+ results = provision_native_assets(force=False)
72
+ print("Provisioning Status:", results)
73
+ ```
51
74
 
52
75
  ### 1.4 Node.js / TypeScript SDK & CLI Installation
53
76
  Install globally or as a project dependency via `npm`:
@@ -33,21 +33,44 @@ To install with full multi-modal engine integrations (STT, TTS, LLM, Diffusion,
33
33
  pip install "ameva-runtime[all]"
34
34
  ```
35
35
 
36
- ### 1.3 1-Click Native Hardware Asset Provisioning (One-Touch Auto-Install)
37
- Provision precompiled ARM64 Bionic binaries, native compute shaders, and hardware drivers in a single command without building from source:
36
+ ### 1.3 1-Click Native Hardware Asset Provisioning & Dual-Track Compatibility
37
+ Rather than requiring users to manually compile C/C++ source trees, setup CMake/Clang toolchains, or configure OpenMP and Vulkan loaders, AMEVA-Runtime includes an automated, atomic hardware provisioner (`NativeAssetManager`):
38
+
38
39
  ```bash
39
- # Provision all modalities (Diffusion, STT, TTS, OpenMP, EGL Shim, SPIR-V Shaders)
40
+ # 1-Click Auto-Provision all 6 modalities and native hardware drivers
40
41
  ameva install --all
41
42
 
42
- # Or provision a specific modality with force overwrite
43
+ # Or alias
44
+ ameva setup
45
+
46
+ # Force overwrite existing binaries with fresh GitHub Release assets
47
+ ameva install --all --force
48
+
49
+ # Provision a single targeted modality
43
50
  ameva install --modality diffusion --force
44
51
  ```
45
- This automatically provisions and links:
46
- * **Stable Diffusion CLI (`sd-cli`)**: `~/.local/bin/sd-cli` (and legacy path `~/.cache/termux-diffusion/bin/sd-cli`)
47
- * **Whisper STT (`whisper-cli`)**: `~/.local/bin/whisper-cli` (and `$PREFIX/bin/whisper-cli`)
48
- * **Sherpa-NCNN TTS (`sherpa-ncnn-offline-tts`)**: `~/.local/bin/sherpa-ncnn-offline-tts`
49
- * **Vulkan HAL Shim & OpenMP (`libegl_shim.so`, `libomp.so`)**: `$PREFIX/lib/`
50
- * **SPIR-V Zero-Stride Bypass Shader (`matmul.spv`)**: `~/.local/share/ameva/shaders/matmul.spv`
52
+
53
+ #### Dual-Track Compatibility Architecture (Track A + Track B)
54
+ AMEVA-Runtime enforces a **Dual-Track Deployment Architecture** to ensure zero-regression interoperability between modern unified environments and existing ecosystem toolchains:
55
+
56
+ | Asset / Engine | Clean Unified Path (Track B) | Legacy Bridge / Symlink (Track A) | Engine Type & Target Modality |
57
+ | :--- | :--- | :--- | :--- |
58
+ | **`sd-cli`** (36.2 MB) | `~/.local/bin/sd-cli` | `~/.cache/termux-diffusion/bin/sd-cli` | Stable Diffusion On-Device Vulkan Engine |
59
+ | **`whisper-cli`** (3.3 MB) | `~/.local/bin/whisper-cli` | `$PREFIX/bin/whisper-cli`, `~/.local/bin/whisper-cpp` | Whisper Speech-to-Text ARM64 Engine |
60
+ | **`sherpa-ncnn-offline-tts`** (3.9 MB) | `~/.local/bin/sherpa-ncnn-offline-tts` | `~/sherpa-ncnn/build-vulkan/bin/`, `$PREFIX/bin/` | Sherpa-NCNN Vulkan Neural Speech Synthesis |
61
+ | **`libomp.so`** (1.1 MB) | `$PREFIX/lib/libomp.so` | `~/.local/lib/libomp.so` | OpenMP High-Throughput Threading Runtime |
62
+ | **`libegl_shim.so`** (8.4 KB) | `$PREFIX/lib/libegl_shim.so` | `~/.local/lib/libegl_shim.so` | Android Termux Headless EGL/GBM Driver Shim |
63
+ | **`matmul.spv`** (4.7 KB) | `~/.local/share/ameva/shaders/matmul.spv` | `$PREFIX/share/ameva/shaders/matmul.spv` | Mali/Adreno Zero-Stride Workaround SPIR-V Shader |
64
+
65
+ #### Programmatic Python Provisioning API
66
+ You can also trigger atomic asset provisioning directly within Python workflows:
67
+ ```python
68
+ from ameva_runtime import provision_native_assets
69
+
70
+ # Provision all native binaries and link compatibility bridges
71
+ results = provision_native_assets(force=False)
72
+ print("Provisioning Status:", results)
73
+ ```
51
74
 
52
75
  ### 1.4 Node.js / TypeScript SDK & CLI Installation
53
76
  Install globally or as a project dependency via `npm`:
@@ -5,4 +5,4 @@ Single Source of Truth (SSOT) for all runtime packages.
5
5
  Modifying this single string updates ameva_runtime, ameva_runtime.vulkan,
6
6
  and the package metadata simultaneously.
7
7
  """
8
- __version__ = "2.2.2"
8
+ __version__ = "2.2.3"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ameva-runtime
3
- Version: 2.2.2
3
+ Version: 2.2.3
4
4
  Summary: Unified Next-Gen Hardware Orchestration & AI Acceleration Runtime for Mobile & Edge
5
5
  Home-page: https://github.com/uno-km/ameva-runtime
6
6
  Author: Eunho Kim
@@ -84,21 +84,44 @@ To install with full multi-modal engine integrations (STT, TTS, LLM, Diffusion,
84
84
  pip install "ameva-runtime[all]"
85
85
  ```
86
86
 
87
- ### 1.3 1-Click Native Hardware Asset Provisioning (One-Touch Auto-Install)
88
- Provision precompiled ARM64 Bionic binaries, native compute shaders, and hardware drivers in a single command without building from source:
87
+ ### 1.3 1-Click Native Hardware Asset Provisioning & Dual-Track Compatibility
88
+ Rather than requiring users to manually compile C/C++ source trees, setup CMake/Clang toolchains, or configure OpenMP and Vulkan loaders, AMEVA-Runtime includes an automated, atomic hardware provisioner (`NativeAssetManager`):
89
+
89
90
  ```bash
90
- # Provision all modalities (Diffusion, STT, TTS, OpenMP, EGL Shim, SPIR-V Shaders)
91
+ # 1-Click Auto-Provision all 6 modalities and native hardware drivers
91
92
  ameva install --all
92
93
 
93
- # Or provision a specific modality with force overwrite
94
+ # Or alias
95
+ ameva setup
96
+
97
+ # Force overwrite existing binaries with fresh GitHub Release assets
98
+ ameva install --all --force
99
+
100
+ # Provision a single targeted modality
94
101
  ameva install --modality diffusion --force
95
102
  ```
96
- This automatically provisions and links:
97
- * **Stable Diffusion CLI (`sd-cli`)**: `~/.local/bin/sd-cli` (and legacy path `~/.cache/termux-diffusion/bin/sd-cli`)
98
- * **Whisper STT (`whisper-cli`)**: `~/.local/bin/whisper-cli` (and `$PREFIX/bin/whisper-cli`)
99
- * **Sherpa-NCNN TTS (`sherpa-ncnn-offline-tts`)**: `~/.local/bin/sherpa-ncnn-offline-tts`
100
- * **Vulkan HAL Shim & OpenMP (`libegl_shim.so`, `libomp.so`)**: `$PREFIX/lib/`
101
- * **SPIR-V Zero-Stride Bypass Shader (`matmul.spv`)**: `~/.local/share/ameva/shaders/matmul.spv`
103
+
104
+ #### Dual-Track Compatibility Architecture (Track A + Track B)
105
+ AMEVA-Runtime enforces a **Dual-Track Deployment Architecture** to ensure zero-regression interoperability between modern unified environments and existing ecosystem toolchains:
106
+
107
+ | Asset / Engine | Clean Unified Path (Track B) | Legacy Bridge / Symlink (Track A) | Engine Type & Target Modality |
108
+ | :--- | :--- | :--- | :--- |
109
+ | **`sd-cli`** (36.2 MB) | `~/.local/bin/sd-cli` | `~/.cache/termux-diffusion/bin/sd-cli` | Stable Diffusion On-Device Vulkan Engine |
110
+ | **`whisper-cli`** (3.3 MB) | `~/.local/bin/whisper-cli` | `$PREFIX/bin/whisper-cli`, `~/.local/bin/whisper-cpp` | Whisper Speech-to-Text ARM64 Engine |
111
+ | **`sherpa-ncnn-offline-tts`** (3.9 MB) | `~/.local/bin/sherpa-ncnn-offline-tts` | `~/sherpa-ncnn/build-vulkan/bin/`, `$PREFIX/bin/` | Sherpa-NCNN Vulkan Neural Speech Synthesis |
112
+ | **`libomp.so`** (1.1 MB) | `$PREFIX/lib/libomp.so` | `~/.local/lib/libomp.so` | OpenMP High-Throughput Threading Runtime |
113
+ | **`libegl_shim.so`** (8.4 KB) | `$PREFIX/lib/libegl_shim.so` | `~/.local/lib/libegl_shim.so` | Android Termux Headless EGL/GBM Driver Shim |
114
+ | **`matmul.spv`** (4.7 KB) | `~/.local/share/ameva/shaders/matmul.spv` | `$PREFIX/share/ameva/shaders/matmul.spv` | Mali/Adreno Zero-Stride Workaround SPIR-V Shader |
115
+
116
+ #### Programmatic Python Provisioning API
117
+ You can also trigger atomic asset provisioning directly within Python workflows:
118
+ ```python
119
+ from ameva_runtime import provision_native_assets
120
+
121
+ # Provision all native binaries and link compatibility bridges
122
+ results = provision_native_assets(force=False)
123
+ print("Provisioning Status:", results)
124
+ ```
102
125
 
103
126
  ### 1.4 Node.js / TypeScript SDK & CLI Installation
104
127
  Install globally or as a project dependency via `npm`:
File without changes
File without changes
File without changes
File without changes