ameva-runtime 2.3.2__tar.gz → 2.3.4__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 (65) hide show
  1. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/LICENSE +17 -17
  2. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/MANIFEST.in +1 -1
  3. ameva_runtime-2.3.4/PKG-INFO +92 -0
  4. ameva_runtime-2.3.4/README.md +111 -0
  5. ameva_runtime-2.3.4/README.pypi.md +41 -0
  6. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/pyproject.toml +136 -135
  7. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/__init__.py +71 -71
  8. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/_version.py +8 -8
  9. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/adapters/bitnet.py +1 -1
  10. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/adapters/llamacpp.py +1 -1
  11. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/adapters/stt.py +1 -1
  12. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/adapters/vision.py +43 -10
  13. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/detector.py +217 -217
  14. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/installer.py +309 -309
  15. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/__init__.py +79 -79
  16. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/bindings.py +124 -124
  17. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/cli.py +1 -1
  18. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/doctor.py +919 -919
  19. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/exceptions.py +1 -1
  20. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/platform.py +270 -270
  21. ameva_runtime-2.3.4/python/ameva_runtime.egg-info/PKG-INFO +92 -0
  22. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime.egg-info/SOURCES.txt +1 -16
  23. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime.egg-info/top_level.txt +0 -1
  24. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/setup.cfg +4 -4
  25. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/setup.py +38 -38
  26. ameva_runtime-2.3.2/PKG-INFO +0 -571
  27. ameva_runtime-2.3.2/README.md +0 -520
  28. ameva_runtime-2.3.2/README.pypi.md +0 -520
  29. ameva_runtime-2.3.2/python/ameva_runtime.egg-info/PKG-INFO +0 -571
  30. ameva_runtime-2.3.2/python/termux_train/__init__.py +0 -30
  31. ameva_runtime-2.3.2/python/termux_train/backends/__init__.py +0 -21
  32. ameva_runtime-2.3.2/python/termux_train/backends/base.py +0 -105
  33. ameva_runtime-2.3.2/python/termux_train/backends/diff.py +0 -27
  34. ameva_runtime-2.3.2/python/termux_train/backends/llm.py +0 -175
  35. ameva_runtime-2.3.2/python/termux_train/backends/stt.py +0 -27
  36. ameva_runtime-2.3.2/python/termux_train/backends/tts.py +0 -27
  37. ameva_runtime-2.3.2/python/termux_train/backends/vision.py +0 -27
  38. ameva_runtime-2.3.2/python/termux_train/cli.py +0 -127
  39. ameva_runtime-2.3.2/python/termux_train/core.py +0 -57
  40. ameva_runtime-2.3.2/python/termux_train/exceptions.py +0 -66
  41. ameva_runtime-2.3.2/python/termux_train/utils/__init__.py +0 -13
  42. ameva_runtime-2.3.2/python/termux_train/utils/hardware.py +0 -95
  43. ameva_runtime-2.3.2/python/termux_train/utils/monitor.py +0 -73
  44. ameva_runtime-2.3.2/tests/test_termux_train.py +0 -143
  45. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/profiles/validated-vulkan-profiles.json +0 -0
  46. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/adapters/__init__.py +0 -0
  47. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/adapters/base.py +0 -0
  48. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/adapters/diffusion.py +0 -0
  49. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/adapters/tts.py +0 -0
  50. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/cli.py +0 -0
  51. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/core.py +0 -0
  52. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/doctor.py +0 -0
  53. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/exceptions.py +0 -0
  54. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/platform.py +0 -0
  55. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/protocol.py +0 -0
  56. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/router.py +0 -0
  57. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/adapters/__init__.py +0 -0
  58. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/core.py +0 -0
  59. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/profiles/__init__.py +0 -0
  60. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/profiles/validated-vulkan-profiles.json +0 -0
  61. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/protocol.py +0 -0
  62. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime/vulkan/py.typed +0 -0
  63. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime.egg-info/dependency_links.txt +0 -0
  64. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime.egg-info/entry_points.txt +0 -0
  65. {ameva_runtime-2.3.2 → ameva_runtime-2.3.4}/python/ameva_runtime.egg-info/requires.txt +0 -0
@@ -1,17 +1,17 @@
1
- Apache License
2
- Version 2.0, January 2004
3
- http://www.apache.org/licenses/
4
-
5
- Copyright 2026 UnoKim & AMEVA Open-Source Foundation
6
-
7
- Licensed under the Apache License, Version 2.0 (the "License");
8
- you may not use this file except in compliance with the License.
9
- You may obtain a copy of the License at
10
-
11
- http://www.apache.org/licenses/LICENSE-2.0
12
-
13
- Unless required by applicable law or agreed to in writing, software
14
- distributed under the License is distributed on an "AS IS" BASIS,
15
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
- See the License for the specific language governing permissions and
17
- limitations under the License.
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ Copyright 2026 UnoKim & AMEVA Open-Source Foundation
6
+
7
+ Licensed under the Apache License, Version 2.0 (the "License");
8
+ you may not use this file except in compliance with the License.
9
+ You may obtain a copy of the License at
10
+
11
+ http://www.apache.org/licenses/LICENSE-2.0
12
+
13
+ Unless required by applicable law or agreed to in writing, software
14
+ distributed under the License is distributed on an "AS IS" BASIS,
15
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ See the License for the specific language governing permissions and
17
+ limitations under the License.
@@ -3,4 +3,4 @@ include README.pypi.md
3
3
  include LICENSE
4
4
  recursive-include profiles *.json
5
5
  recursive-include python/ameva_runtime/vulkan/profiles *.json
6
- recursive-include python/ameva_runtime/vulkan/lib *.so *.dll
6
+ recursive-include python/ameva_runtime/vulkan/lib *.so *.dll
@@ -0,0 +1,92 @@
1
+ Metadata-Version: 2.4
2
+ Name: ameva-runtime
3
+ Version: 2.3.4
4
+ Summary: Unified Next-Gen Hardware Orchestration & AI Acceleration Runtime for Mobile & Edge
5
+ Home-page: https://github.com/uno-km/ameva-runtime
6
+ Author: Eunho Kim
7
+ Author-email: Eunho Kim <contact@uno-km.com>
8
+ License: Apache-2.0
9
+ Project-URL: Homepage, https://uno-km.vercel.app/lib/vulkan/
10
+ Project-URL: Repository, https://github.com/uno-km/ameva-runtime
11
+ Project-URL: Documentation, https://uno-km.vercel.app/lib/vulkan/
12
+ Keywords: vulkan-compute,mobile-gpu,hardware-acceleration,hardware-abstraction-layer,adreno-gpu,arm-mali,snapdragon-8-elite,exynos,termux,on-device-ai,edge-ai,tensor-acceleration,spir-v,compute-shaders,zero-silent-fallback,llamacpp,whisper-cpp,sherpa-onnx,stable-diffusion,vision-language-models,bitnet,gguf,ncnn,bionic-loader,arm64,aarch64,cgroup-management,cpu-neon,thermal-throttling,power-efficiency,smart-router,hardware-orchestration,multi-modal-ai,subgroup-operations,gemm-acceleration,mobile-vlm,speech-to-text,text-to-speech,image-generation,edge-inference,unprivileged-userspace,termux-wake-lock,phantom-process-killer,android-ai-runtime,valhall-gpu,adreno-830,mali-g68,ameva-foundation,uno-km,open-source-ai
13
+ Classifier: Development Status :: 5 - Production/Stable
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: License :: OSI Approved :: Apache Software License
16
+ Classifier: Operating System :: POSIX :: Linux
17
+ Classifier: Operating System :: Android
18
+ Classifier: Programming Language :: Python :: 3
19
+ Classifier: Programming Language :: Python :: 3.8
20
+ Classifier: Programming Language :: Python :: 3.9
21
+ Classifier: Programming Language :: Python :: 3.10
22
+ Classifier: Programming Language :: Python :: 3.11
23
+ Classifier: Programming Language :: Python :: 3.12
24
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
25
+ Requires-Python: >=3.8
26
+ Description-Content-Type: text/markdown
27
+ License-File: LICENSE
28
+ Provides-Extra: stt
29
+ Requires-Dist: termux-stt>=1.2.0; extra == "stt"
30
+ Provides-Extra: diffusion
31
+ Requires-Dist: termux-diffusion>=1.5.0; extra == "diffusion"
32
+ Provides-Extra: bitnet
33
+ Requires-Dist: termux-bitnet>=1.2.0; extra == "bitnet"
34
+ Provides-Extra: llamacpp
35
+ Requires-Dist: termux-llamacpp>=1.3.0; extra == "llamacpp"
36
+ Provides-Extra: tts
37
+ Requires-Dist: termux-tts>=1.4.0; extra == "tts"
38
+ Provides-Extra: vision
39
+ Requires-Dist: termux-vision>=1.2.0; extra == "vision"
40
+ Provides-Extra: all
41
+ Requires-Dist: termux-stt>=1.2.0; extra == "all"
42
+ Requires-Dist: termux-diffusion>=1.5.0; extra == "all"
43
+ Requires-Dist: termux-bitnet>=1.2.0; extra == "all"
44
+ Requires-Dist: termux-llamacpp>=1.3.0; extra == "all"
45
+ Requires-Dist: termux-tts>=1.4.0; extra == "all"
46
+ Requires-Dist: termux-vision>=1.2.0; extra == "all"
47
+ Dynamic: author
48
+ Dynamic: home-page
49
+ Dynamic: license-file
50
+ Dynamic: requires-python
51
+
52
+ # AMEVA-Runtime (Python)
53
+
54
+ [![PyPI](https://img.shields.io/pypi/v/ameva-runtime.svg?style=flat-square&color=0369a1)](https://pypi.org/project/ameva-runtime/)
55
+ [![Python](https://img.shields.io/pypi/pyversions/ameva-runtime.svg?style=flat-square)](https://pypi.org/project/ameva-runtime/)
56
+ [![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/ameva-runtime)
57
+
58
+ > Next-Gen Unified On-Device Hardware Orchestration & 6-Modality AI Acceleration Runtime for Mobile & Edge
59
+
60
+ ## Installation
61
+
62
+ ```bash
63
+ pip install ameva-runtime
64
+ ```
65
+
66
+ ## Quickstart
67
+
68
+ ```python
69
+ import ameva_runtime as ameva
70
+ from ameva_runtime import vulkan
71
+
72
+ # Inspect hardware
73
+ profile = ameva.detect_hardware()
74
+ print(f"Target: {profile.soc_name} | {profile.gpu_vendor}")
75
+
76
+ # Run diagnostics
77
+ doc = vulkan.Doctor()
78
+ report = doc.run_self_test()
79
+ print(f"Passed: {report.passed_stages}/{report.total_stages}")
80
+ ```
81
+
82
+ ## Empirical Benchmarks
83
+
84
+ - **Galaxy S25 (Adreno 830)**: LLM 35.80 t/s (VRAM 25/25 layers), Whisper STT 4,401 ms, TTS RTF 0.264x (medium) / 0.993x (high-fp16).
85
+ - **Galaxy A35 (Mali-G68 MP5)**: LLM 4.44 t/s (+26.9% vs NEON), Whisper STT 360.60s (2.26x speedup), TTS RTF 1.146x.
86
+
87
+ ## Documentation
88
+ - [Official Documentation](https://uno-km.vercel.app/lib/vulkan/)
89
+ - [GitHub Repository](https://github.com/uno-km/ameva-runtime)
90
+
91
+ ## License
92
+ Apache-2.0 License. Copyright (c) 2026 Eunho Kim (@uno-km).
@@ -0,0 +1,111 @@
1
+ # AMEVA-Runtime
2
+
3
+ [![PyPI](https://img.shields.io/pypi/v/ameva-runtime.svg?style=flat-square&color=0369a1)](https://pypi.org/project/ameva-runtime/)
4
+ [![Python](https://img.shields.io/pypi/pyversions/ameva-runtime.svg?style=flat-square)](https://pypi.org/project/ameva-runtime/)
5
+ [![npm](https://img.shields.io/npm/v/@ameva/runtime.svg?style=flat-square&color=b91c1c)](https://www.npmjs.com/package/@ameva/runtime)
6
+ [![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/ameva-runtime)
7
+
8
+ > Next-Gen Unified On-Device Hardware Orchestration & 6-Modality AI Acceleration Runtime for Mobile & Edge
9
+
10
+ ---
11
+
12
+ ## Architecture & Overview
13
+
14
+ AMEVA-Runtime is a hardware abstraction layer (HAL) and compute orchestration engine engineered specifically for mobile ARM64 devices (Android Termux, Linux Edge). It continuously inspects underlying silicon topology (/dev/kgsl-3d0, /dev/mali0) to route tensor execution across Qualcomm Adreno, ARM Mali, and ARM Cortex CPU-NEON backends.
15
+
16
+ ### 6-Modality Acceleration Matrix
17
+
18
+ | Modality | Engine Integration | Status (v2.1.0) | Hardware Acceleration Mechanism |
19
+ | :--- | :--- | :---: | :--- |
20
+ | **1. LLM (Text)** | Llama.cpp (Qwen2.5, Llama 3.2) | **Production** | Full 25/25 layer VRAM offload (Adreno 35.80 t/s, Mali 4.44 t/s) |
21
+ | **2. STT (Speech)** | Whisper.cpp (Large-v3-Turbo) | **Production** | Vulkan compute shader acceleration (Adreno 4.4s, Mali 2.26x speedup) |
22
+ | **3. TTS (Audio)** | Sherpa-NCNN / Piper | **Production** | Pure Vulkan GPU neural synthesis (Adreno RTF 0.264x, Mali RTF 1.146x) |
23
+ | **4. Vision (VLM)** | CLIP / MobileVLM / LLaVA | **In Development** | GGML Vulkan vision encoder tensor bindings |
24
+ | **5. Diffusion (Image)** | Stable Diffusion v1.5 / FLUX.1 | **In Development** | On-device Vulkan UNet & DiT tensor offload |
25
+ | **6. Train (Training)** | On-Device LoRA / QLoRA | **In Development** | Mobile Vulkan gradient descent backpropagation |
26
+
27
+ ---
28
+
29
+ ## Empirical Physical Device Benchmarks
30
+
31
+ Tested on physical devices running Android 16 under Termux ARM64:
32
+
33
+ ### 1. LLM Generation (Qwen2.5-0.5B-Instruct Q4_K_M)
34
+ | Target Device | Hardware Architecture | Active Backend | Layers in VRAM | Generation Speed | Prompt Processing | Speedup |
35
+ | :--- | :--- | :---: | :---: | :---: | :---: | :---: |
36
+ | **Galaxy S25** | Snapdragon 8 Elite / Adreno 830 | Vulkan 1.3 | **25/25 (100%)** | **35.80 t/s** (27.9 ms/t) | 4.53 t/s | **35.8x (vs CPU)** |
37
+ | **Galaxy A35** | Exynos 1380 / ARM Mali-G68 MP5 | Vulkan 1.3 | **25/25 (100%)** | **4.44 t/s** (225 ms/t) | 6.12 t/s | **+26.9% (vs NEON)** |
38
+ | **Galaxy A35** | Cortex-A78 CPU-NEON (3 Threads) | CPU-NEON | 0/25 | 3.55 t/s (281 ms/t) | 8.05 t/s | Baseline |
39
+
40
+ ### 2. Speech-to-Text (Whisper Large-v3-Turbo Q5_0, 548MB)
41
+ | Target Device | Hardware Architecture | Backend Mode | Latency (1-min audio) | GPU Load | CPU Load | Speedup |
42
+ | :--- | :--- | :---: | :---: | :---: | :---: | :---: |
43
+ | **Galaxy A35** | Exynos 1380 / Mali-G68 MP5 | Vulkan GPU | **360.60 s (6m 00s)** | **949 MHz (100%)** | 20~30% | **2.26x (56% time saved)** |
44
+ | **Galaxy A35** | Cortex-A78 x4 Cores | CPU-NEON | 816.48 s (13m 36s) | 0% | 291% | Baseline |
45
+
46
+ ### 3. Text-to-Speech (Termux-TTS v1.3.0 Vulkan)
47
+ | Target Device | Hardware Architecture | Model Tier | Audio Length | Compute Time | Real-Time Factor (RTF) | Status |
48
+ | :--- | :--- | :--- | :---: | :---: | :---: | :---: |
49
+ | **Galaxy S25** | Snapdragon 8 Elite / Adreno 830 | `lessac-high-fp16` | 6.70 s | **6.65 s** | **0.993x** | Real-time Studio |
50
+ | **Galaxy S25** | Snapdragon 8 Elite / Adreno 830 | `lessac-medium` | 4.59 s | **1.21 s** | **0.264x** | 3.79x Faster than RT |
51
+ | **Galaxy A35** | Exynos 1380 / Mali-G68 MP5 | `lessac-medium` | 4.52 s | **5.18 s** | **1.146x** | Validated |
52
+
53
+ ---
54
+
55
+ ## Root-Cause Driver Solutions
56
+
57
+ 1. **ARM Mali-G68 Valhall Integer Truncation**: Enforced medium tile matmul kernel dispatch (`loadstride_b = 4 > 0`), permanently eliminating shader zero-stride infinite loops on subgroup-16 hardware.
58
+ 2. **Qualcomm Adreno 830 JIT Register Bug**: Bounded vector column specialization (`mul_mat_vec_max_cols = 2`), preventing compiler crash `VK_ERROR_UNKNOWN (-13)`.
59
+ 3. **Zero-Silent-Fallback**: Guaranteed fail-fast architecture without silent CPU degradation upon GPU driver faults.
60
+
61
+ ---
62
+
63
+ ## Installation
64
+
65
+ ```bash
66
+ # Python SDK
67
+ pip install ameva-runtime
68
+
69
+ # Node.js / TypeScript
70
+ npm install @ameva/runtime
71
+ ```
72
+
73
+ ---
74
+
75
+ ## Quickstart
76
+
77
+ ### Python SDK
78
+ ```python
79
+ import ameva_runtime as ameva
80
+ from ameva_runtime import vulkan
81
+
82
+ # 1. Inspect on-device silicon topology
83
+ profile = ameva.detect_hardware()
84
+ print(f"SoC: {profile.soc_name} | GPU: {profile.gpu_vendor}")
85
+
86
+ # 2. Run hardware self-test
87
+ doc = vulkan.Doctor()
88
+ report = doc.run_self_test()
89
+ print(f"GPU: {report.device_name} (Passed: {report.passed_stages}/{report.total_stages})")
90
+ ```
91
+
92
+ ### Node.js / TypeScript
93
+ ```typescript
94
+ import { Doctor, createContext } from '@ameva/runtime';
95
+
96
+ const doc = new Doctor();
97
+ const report = await doc.runSelfTest();
98
+ console.log(`Vulkan GPU: ${report.deviceName}`);
99
+ ```
100
+
101
+ ---
102
+
103
+ ## Official Documentation & Benchmarks
104
+ - [Official Architecture & API Reference](https://uno-km.vercel.app/lib/vulkan/)
105
+ - [Ecosystem Metrics & Registry Stats](https://uno-km.vercel.app/foundation/metrics)
106
+ - [AMEVA Open-Source Foundation Portal](https://uno-km.vercel.app/foundation/index.html)
107
+
108
+ ---
109
+
110
+ ## License
111
+ Licensed under the Apache-2.0 License. Copyright (c) 2026 Eunho Kim ([@uno-km](https://github.com/uno-km)).
@@ -0,0 +1,41 @@
1
+ # AMEVA-Runtime (Python)
2
+
3
+ [![PyPI](https://img.shields.io/pypi/v/ameva-runtime.svg?style=flat-square&color=0369a1)](https://pypi.org/project/ameva-runtime/)
4
+ [![Python](https://img.shields.io/pypi/pyversions/ameva-runtime.svg?style=flat-square)](https://pypi.org/project/ameva-runtime/)
5
+ [![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/ameva-runtime)
6
+
7
+ > Next-Gen Unified On-Device Hardware Orchestration & 6-Modality AI Acceleration Runtime for Mobile & Edge
8
+
9
+ ## Installation
10
+
11
+ ```bash
12
+ pip install ameva-runtime
13
+ ```
14
+
15
+ ## Quickstart
16
+
17
+ ```python
18
+ import ameva_runtime as ameva
19
+ from ameva_runtime import vulkan
20
+
21
+ # Inspect hardware
22
+ profile = ameva.detect_hardware()
23
+ print(f"Target: {profile.soc_name} | {profile.gpu_vendor}")
24
+
25
+ # Run diagnostics
26
+ doc = vulkan.Doctor()
27
+ report = doc.run_self_test()
28
+ print(f"Passed: {report.passed_stages}/{report.total_stages}")
29
+ ```
30
+
31
+ ## Empirical Benchmarks
32
+
33
+ - **Galaxy S25 (Adreno 830)**: LLM 35.80 t/s (VRAM 25/25 layers), Whisper STT 4,401 ms, TTS RTF 0.264x (medium) / 0.993x (high-fp16).
34
+ - **Galaxy A35 (Mali-G68 MP5)**: LLM 4.44 t/s (+26.9% vs NEON), Whisper STT 360.60s (2.26x speedup), TTS RTF 1.146x.
35
+
36
+ ## Documentation
37
+ - [Official Documentation](https://uno-km.vercel.app/lib/vulkan/)
38
+ - [GitHub Repository](https://github.com/uno-km/ameva-runtime)
39
+
40
+ ## License
41
+ Apache-2.0 License. Copyright (c) 2026 Eunho Kim (@uno-km).
@@ -1,135 +1,136 @@
1
- [build-system]
2
- requires = ["setuptools>=61.0", "wheel"]
3
- build-backend = "setuptools.build_meta"
4
-
5
- [project]
6
- name = "ameva-runtime"
7
- dynamic = ["version"]
8
- description = "Unified Next-Gen Hardware Orchestration & AI Acceleration Runtime for Mobile & Edge"
9
-
10
- readme = "README.pypi.md"
11
- requires-python = ">=3.8"
12
- license = { text = "Apache-2.0" }
13
- authors = [{ name = "Eunho Kim", email = "contact@uno-km.com" }]
14
- keywords = [
15
- "vulkan-compute",
16
- "mobile-gpu",
17
- "hardware-acceleration",
18
- "hardware-abstraction-layer",
19
- "adreno-gpu",
20
- "arm-mali",
21
- "snapdragon-8-elite",
22
- "exynos",
23
- "termux",
24
- "on-device-ai",
25
- "edge-ai",
26
- "tensor-acceleration",
27
- "spir-v",
28
- "compute-shaders",
29
- "zero-silent-fallback",
30
- "llamacpp",
31
- "whisper-cpp",
32
- "sherpa-onnx",
33
- "stable-diffusion",
34
- "vision-language-models",
35
- "bitnet",
36
- "gguf",
37
- "ncnn",
38
- "bionic-loader",
39
- "arm64",
40
- "aarch64",
41
- "cgroup-management",
42
- "cpu-neon",
43
- "thermal-throttling",
44
- "power-efficiency",
45
- "smart-router",
46
- "hardware-orchestration",
47
- "multi-modal-ai",
48
- "subgroup-operations",
49
- "gemm-acceleration",
50
- "mobile-vlm",
51
- "speech-to-text",
52
- "text-to-speech",
53
- "image-generation",
54
- "edge-inference",
55
- "unprivileged-userspace",
56
- "termux-wake-lock",
57
- "phantom-process-killer",
58
- "android-ai-runtime",
59
- "valhall-gpu",
60
- "adreno-830",
61
- "mali-g68",
62
- "ameva-foundation",
63
- "uno-km",
64
- "open-source-ai"
65
- ]
66
- classifiers = [
67
- "Development Status :: 5 - Production/Stable",
68
- "Intended Audience :: Developers",
69
- "License :: OSI Approved :: Apache Software License",
70
- "Operating System :: POSIX :: Linux",
71
- "Operating System :: Android",
72
- "Programming Language :: Python :: 3",
73
- "Programming Language :: Python :: 3.8",
74
- "Programming Language :: Python :: 3.9",
75
- "Programming Language :: Python :: 3.10",
76
- "Programming Language :: Python :: 3.11",
77
- "Programming Language :: Python :: 3.12",
78
- "Topic :: Scientific/Engineering :: Artificial Intelligence",
79
- ]
80
-
81
- [project.scripts]
82
- ameva = "ameva_runtime.cli:main"
83
- ameva-run = "ameva_runtime.cli:main"
84
- ameva-gpu = "ameva_runtime.cli:legacy_gpu_main"
85
- ameva-doctor = "ameva_runtime.cli:main"
86
- ameva-vulkan = "ameva_runtime.cli:main"
87
-
88
- [project.urls]
89
- Homepage = "https://uno-km.vercel.app/lib/vulkan/"
90
- Repository = "https://github.com/uno-km/ameva-runtime"
91
- Documentation = "https://uno-km.vercel.app/lib/vulkan/"
92
-
93
- [project.optional-dependencies]
94
- stt = ["termux-stt>=1.2.0"]
95
- diffusion = ["termux-diffusion>=1.5.0"]
96
- bitnet = ["termux-bitnet>=1.2.0"]
97
- llamacpp = ["termux-llamacpp>=1.3.0"]
98
- tts = ["termux-tts>=1.4.0"]
99
- vision = ["termux-vision>=1.2.0"]
100
- all = [
101
- "termux-stt>=1.2.0",
102
- "termux-diffusion>=1.5.0",
103
- "termux-bitnet>=1.2.0",
104
- "termux-llamacpp>=1.3.0",
105
- "termux-tts>=1.4.0",
106
- "termux-vision>=1.2.0",
107
- ]
108
-
109
- [tool.pytest.ini_options]
110
- pythonpath = ["python"]
111
- testpaths = ["python/tests"]
112
-
113
- [tool.setuptools]
114
- package-dir = {"" = "python"}
115
-
116
- [tool.setuptools.packages.find]
117
- where = ["python"]
118
- exclude = ["tests*", "*tests*"]
119
-
120
- [tool.setuptools.dynamic]
121
- version = {attr = "ameva_runtime._version.__version__"}
122
-
123
-
124
-
125
-
126
- [tool.setuptools.package-data]
127
- "ameva_runtime" = [
128
- "py.typed",
129
- ]
130
- "ameva_runtime.vulkan" = [
131
- "profiles/*.json",
132
- "lib/*.so",
133
- "lib/*.dll",
134
- "py.typed",
135
- ]
1
+ [build-system]
2
+ requires = ["setuptools>=61.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "ameva-runtime"
7
+ dynamic = ["version"]
8
+ description = "Unified Next-Gen Hardware Orchestration & AI Acceleration Runtime for Mobile & Edge"
9
+
10
+ readme = "README.pypi.md"
11
+ requires-python = ">=3.8"
12
+ license = { text = "Apache-2.0" }
13
+ authors = [{ name = "Eunho Kim", email = "contact@uno-km.com" }]
14
+ keywords = [
15
+ "vulkan-compute",
16
+ "mobile-gpu",
17
+ "hardware-acceleration",
18
+ "hardware-abstraction-layer",
19
+ "adreno-gpu",
20
+ "arm-mali",
21
+ "snapdragon-8-elite",
22
+ "exynos",
23
+ "termux",
24
+ "on-device-ai",
25
+ "edge-ai",
26
+ "tensor-acceleration",
27
+ "spir-v",
28
+ "compute-shaders",
29
+ "zero-silent-fallback",
30
+ "llamacpp",
31
+ "whisper-cpp",
32
+ "sherpa-onnx",
33
+ "stable-diffusion",
34
+ "vision-language-models",
35
+ "bitnet",
36
+ "gguf",
37
+ "ncnn",
38
+ "bionic-loader",
39
+ "arm64",
40
+ "aarch64",
41
+ "cgroup-management",
42
+ "cpu-neon",
43
+ "thermal-throttling",
44
+ "power-efficiency",
45
+ "smart-router",
46
+ "hardware-orchestration",
47
+ "multi-modal-ai",
48
+ "subgroup-operations",
49
+ "gemm-acceleration",
50
+ "mobile-vlm",
51
+ "speech-to-text",
52
+ "text-to-speech",
53
+ "image-generation",
54
+ "edge-inference",
55
+ "unprivileged-userspace",
56
+ "termux-wake-lock",
57
+ "phantom-process-killer",
58
+ "android-ai-runtime",
59
+ "valhall-gpu",
60
+ "adreno-830",
61
+ "mali-g68",
62
+ "ameva-foundation",
63
+ "uno-km",
64
+ "open-source-ai"
65
+ ]
66
+ classifiers = [
67
+ "Development Status :: 5 - Production/Stable",
68
+ "Intended Audience :: Developers",
69
+ "License :: OSI Approved :: Apache Software License",
70
+ "Operating System :: POSIX :: Linux",
71
+ "Operating System :: Android",
72
+ "Programming Language :: Python :: 3",
73
+ "Programming Language :: Python :: 3.8",
74
+ "Programming Language :: Python :: 3.9",
75
+ "Programming Language :: Python :: 3.10",
76
+ "Programming Language :: Python :: 3.11",
77
+ "Programming Language :: Python :: 3.12",
78
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
79
+ ]
80
+
81
+ [project.scripts]
82
+ ameva = "ameva_runtime.cli:main"
83
+ ameva-run = "ameva_runtime.cli:main"
84
+ ameva-gpu = "ameva_runtime.cli:legacy_gpu_main"
85
+ ameva-doctor = "ameva_runtime.cli:main"
86
+ ameva-vulkan = "ameva_runtime.cli:main"
87
+
88
+ [project.urls]
89
+ Homepage = "https://uno-km.vercel.app/lib/vulkan/"
90
+ Repository = "https://github.com/uno-km/ameva-runtime"
91
+ Documentation = "https://uno-km.vercel.app/lib/vulkan/"
92
+
93
+ [project.optional-dependencies]
94
+ stt = ["termux-stt>=1.2.0"]
95
+ diffusion = ["termux-diffusion>=1.5.0"]
96
+ bitnet = ["termux-bitnet>=1.2.0"]
97
+ llamacpp = ["termux-llamacpp>=1.3.0"]
98
+ tts = ["termux-tts>=1.4.0"]
99
+ vision = ["termux-vision>=1.2.0"]
100
+ all = [
101
+ "termux-stt>=1.2.0",
102
+ "termux-diffusion>=1.5.0",
103
+ "termux-bitnet>=1.2.0",
104
+ "termux-llamacpp>=1.3.0",
105
+ "termux-tts>=1.4.0",
106
+ "termux-vision>=1.2.0",
107
+ ]
108
+
109
+ [tool.pytest.ini_options]
110
+ pythonpath = ["python"]
111
+ testpaths = ["python/tests"]
112
+
113
+ [tool.setuptools]
114
+ package-dir = {"" = "python"}
115
+
116
+ [tool.setuptools.packages.find]
117
+ where = ["python"]
118
+ include = ["ameva_runtime*"]
119
+ exclude = ["tests*", "*tests*"]
120
+
121
+ [tool.setuptools.dynamic]
122
+ version = {attr = "ameva_runtime._version.__version__"}
123
+
124
+
125
+
126
+
127
+ [tool.setuptools.package-data]
128
+ "ameva_runtime" = [
129
+ "py.typed",
130
+ ]
131
+ "ameva_runtime.vulkan" = [
132
+ "profiles/*.json",
133
+ "lib/*.so",
134
+ "lib/*.dll",
135
+ "py.typed",
136
+ ]