ameva-runtime 2.5.0__tar.gz

ameva_runtime-2.5.0/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 UnoKim & AMEVA Open-Source Foundation
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

ameva_runtime-2.5.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include README.pypi.md
+include LICENSE
+recursive-include profiles *.json
+recursive-include python/ameva_runtime/vulkan/profiles *.json
+recursive-include python/ameva_runtime/vulkan/lib *.so *.dll

ameva_runtime-2.5.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: ameva-runtime
+Version: 2.5.0
+Summary: Unified Next-Gen Hardware Orchestration & AI Acceleration Runtime for Mobile & Edge
+Home-page: https://github.com/uno-km/ameva-runtime
+Author: Eunho Kim
+Author-email: Eunho Kim <contact@uno-km.com>
+License: Apache-2.0
+Project-URL: Homepage, https://uno-km.vercel.app/lib/vulkan/
+Project-URL: Repository, https://github.com/uno-km/ameva-runtime
+Project-URL: Documentation, https://uno-km.vercel.app/lib/vulkan/
+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
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software 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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: stt
+Requires-Dist: termux-stt>=1.2.0; extra == "stt"
+Provides-Extra: diffusion
+Requires-Dist: termux-diffusion>=1.5.0; extra == "diffusion"
+Provides-Extra: bitnet
+Requires-Dist: termux-bitnet>=1.2.0; extra == "bitnet"
+Provides-Extra: llamacpp
+Requires-Dist: termux-llamacpp>=1.3.0; extra == "llamacpp"
+Provides-Extra: tts
+Requires-Dist: termux-tts>=1.4.0; extra == "tts"
+Provides-Extra: vision
+Requires-Dist: termux-vision>=1.2.0; extra == "vision"
+Provides-Extra: all
+Requires-Dist: termux-stt>=1.2.0; extra == "all"
+Requires-Dist: termux-diffusion>=1.5.0; extra == "all"
+Requires-Dist: termux-bitnet>=1.2.0; extra == "all"
+Requires-Dist: termux-llamacpp>=1.3.0; extra == "all"
+Requires-Dist: termux-tts>=1.4.0; extra == "all"
+Requires-Dist: termux-vision>=1.2.0; extra == "all"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# AMEVA-Runtime (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/ameva-runtime.svg?style=flat-square&color=0369a1)](https://pypi.org/project/ameva-runtime/)
+[![Python](https://img.shields.io/pypi/pyversions/ameva-runtime.svg?style=flat-square)](https://pypi.org/project/ameva-runtime/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/ameva-runtime)
+
+> Next-Gen Unified On-Device Hardware Orchestration & 6-Modality AI Acceleration Runtime (with BitNet 1.58-bit Vulkan Compute) for Mobile & Edge
+
+## Installation
+
+```bash
+pip install ameva-runtime
+```
+
+## Quickstart
+
+```python
+import ameva_runtime as ameva
+from ameva_runtime import vulkan
+
+# Inspect hardware
+profile = ameva.detect_hardware()
+print(f"Target: {profile.soc_name} | {profile.gpu_vendor}")
+
+# Run diagnostics
+doc = vulkan.Doctor()
+report = doc.run_self_test()
+print(f"Passed: {report.passed_stages}/{report.total_stages}")
+```
+
+## Empirical Benchmarks
+
+- **Galaxy S25 (Adreno 830)**:
+  - BitNet 1.58-bit LLM: **17.558 t/s (12.58x speedup)**, Prompt Eval **205.9 ms**.
+  - Qwen2.5-0.5B LLM: **35.80 t/s** (25/25 VRAM layers).
+  - Whisper STT: **4,401 ms**, TTS: RTF **0.264x** (medium) / **0.993x** (high-fp16).
+- **Galaxy A35 (Mali-G68 MP5)**:
+  - BitNet 1.58-bit LLM: **3.471 t/s (5.94x speedup)**, Prompt Eval **1,552.8 ms**.
+  - Qwen2.5-0.5B LLM: **4.44 t/s** (+26.9% vs NEON).
+  - Whisper STT: **360.60s (2.26x speedup)**, TTS: RTF **1.146x**.
+
+## Documentation
+- [Official Documentation](https://uno-km.vercel.app/lib/vulkan/)
+- [GitHub Repository](https://github.com/uno-km/ameva-runtime)
+
+## License
+Apache-2.0 License. Copyright (c) 2026 Eunho Kim (@uno-km).

ameva_runtime-2.5.0/README.md

@@ -0,0 +1,121 @@
+# AMEVA-Runtime
+
+[![PyPI](https://img.shields.io/pypi/v/ameva-runtime.svg?style=flat-square&color=0369a1)](https://pypi.org/project/ameva-runtime/)
+[![Python](https://img.shields.io/pypi/pyversions/ameva-runtime.svg?style=flat-square)](https://pypi.org/project/ameva-runtime/)
+[![npm](https://img.shields.io/npm/v/@ameva/runtime.svg?style=flat-square&color=b91c1c)](https://www.npmjs.com/package/@ameva/runtime)
+[![GitHub Release](https://img.shields.io/github/v/release/uno-km/ameva-runtime?style=flat-square&color=0969da)](https://github.com/uno-km/ameva-runtime/releases/tag/v2.5.0)
+[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/ameva-runtime)
+<img src="https://img.shields.io/badge/BitNet%201.58b-Vulkan%20Compute%20Accelerated-purple.svg?logo=vulkan&logoColor=white" alt="BitNet Vulkan">
+
+> Next-Gen Unified On-Device Hardware Orchestration & 6-Modality AI Acceleration Runtime (with BitNet 1.58-bit Vulkan Compute) for Mobile & Edge
+
+---
+
+## Architecture & Overview
+
+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.
+
+### 6-Modality Acceleration Matrix
+
+| Modality | Engine Integration | Status (v2.5.0) | Hardware Acceleration Mechanism |
+| :--- | :--- | :---: | :--- |
+| **1. LLM (Text)** | Llama.cpp & Termux-BitNet (1.58-bit i2_s) | **Production (v2.5.0)** | Vulkan 25/25 layer VRAM offload (Adreno 35.8 t/s) & BitNet 1.58-bit full pipeline (Adreno 17.56 t/s, Mali 3.47 t/s) |
+| **2. STT (Speech)** | Whisper.cpp (Large-v3-Turbo) | **Production** | Vulkan compute shader acceleration (Adreno 4.4s, Mali 2.26x speedup) |
+| **3. TTS (Audio)** | Sherpa-NCNN / Piper | **Production** | Pure Vulkan GPU neural synthesis (Adreno RTF 0.264x, Mali RTF 1.146x) |
+| **4. Vision (VLM)** | CLIP / MobileVLM / LLaVA | **In Development** | GGML Vulkan vision encoder tensor bindings |
+| **5. Diffusion (Image)** | Stable Diffusion v1.5 / FLUX.1 | **In Development** | On-device Vulkan UNet & DiT tensor offload |
+| **6. Train (Training)** | On-Device LoRA / QLoRA | **In Development** | Mobile Vulkan gradient descent backpropagation |
+
+---
+
+## Empirical Physical Device Benchmarks
+
+Tested on physical devices running Android 16 under Termux ARM64:
+
+### 1. LLM Generation (Qwen2.5-0.5B-Instruct Q4_K_M)
+| Target Device | Hardware Architecture | Active Backend | Layers in VRAM | Generation Speed | Prompt Processing | Speedup |
+| :--- | :--- | :---: | :---: | :---: | :---: | :---: |
+| **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)** |
+| **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)** |
+| **Galaxy A35** | Cortex-A78 CPU-NEON (3 Threads) | CPU-NEON | 0/25 | 3.55 t/s (281 ms/t) | 8.05 t/s | Baseline |
+
+### 2. Speech-to-Text (Whisper Large-v3-Turbo Q5_0, 548MB)
+| Target Device | Hardware Architecture | Backend Mode | Latency (1-min audio) | GPU Load | CPU Load | Speedup |
+| :--- | :--- | :---: | :---: | :---: | :---: | :---: |
+| **Galaxy A35** | Exynos 1380 / Mali-G68 MP5 | Vulkan GPU | **360.60 s (6m 00s)** | **949 MHz (100%)** | 20~30% | **2.26x (56% time saved)** |
+| **Galaxy A35** | Cortex-A78 x4 Cores | CPU-NEON | 816.48 s (13m 36s) | 0% | 291% | Baseline |
+
+### 3. Text-to-Speech (Termux-TTS v1.3.0 Vulkan)
+| Target Device | Hardware Architecture | Model Tier | Audio Length | Compute Time | Real-Time Factor (RTF) | Status |
+| :--- | :--- | :--- | :---: | :---: | :---: | :---: |
+| **Galaxy S25** | Snapdragon 8 Elite / Adreno 830 | `lessac-high-fp16` | 6.70 s | **6.65 s** | **0.993x** | Real-time Studio |
+| **Galaxy S25** | Snapdragon 8 Elite / Adreno 830 | `lessac-medium` | 4.59 s | **1.21 s** | **0.264x** | 3.79x Faster than RT |
+| **Galaxy A35** | Exynos 1380 / Mali-G68 MP5 | `lessac-medium` | 4.52 s | **5.18 s** | **1.146x** | Validated |
+
+---
+
+### 4. BitNet 1.58-bit LLM (Microsoft BitNet b1.58 2B-4T i2_s)
+| Target Device | Hardware Architecture | Active Backend | Generation Speed | Prompt Latency | Speedup | Status |
+| :--- | :--- | :---: | :---: | :---: | :---: | :---: |
+| **Galaxy S25** | Snapdragon 8 Elite / Adreno 830 | **AMEVA Vulkan GPU** | **17.558 t/s** | **205.9 ms** | **12.58x** | **Verified (Ground Truth)** |
+| Galaxy S25 | Snapdragon 8 Elite / Oryon CPU | Native CPU (4 Threads) | 1.396 t/s | 2,041.0 ms | 1.00x | Baseline |
+| **Galaxy A35** | Exynos 1380 / Mali-G68 MP5 | **AMEVA Vulkan GPU** | **3.471 t/s** | **1,552.8 ms** | **5.94x** | **Verified (Ground Truth)** |
+| Galaxy A35 | Exynos 1380 / Cortex-A78 CPU | Native CPU (4 Threads) | 0.584 t/s | 8,775.0 ms | 1.00x | Baseline |
+
+## Root-Cause Driver Solutions
+
+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.
+2. **Qualcomm Adreno 830 JIT Register Bug**: Bounded vector column specialization (`mul_mat_vec_max_cols = 2`), preventing compiler crash `VK_ERROR_UNKNOWN (-13)`.
+3. **Zero-Silent-Fallback**: Guaranteed fail-fast architecture without silent CPU degradation upon GPU driver faults.
+
+---
+
+## Installation
+
+```bash
+# Python SDK
+pip install ameva-runtime
+
+# Node.js / TypeScript
+npm install @ameva/runtime
+```
+
+---
+
+## Quickstart
+
+### Python SDK
+```python
+import ameva_runtime as ameva
+from ameva_runtime import vulkan
+
+# 1. Inspect on-device silicon topology
+profile = ameva.detect_hardware()
+print(f"SoC: {profile.soc_name} | GPU: {profile.gpu_vendor}")
+
+# 2. Run hardware self-test
+doc = vulkan.Doctor()
+report = doc.run_self_test()
+print(f"GPU: {report.device_name} (Passed: {report.passed_stages}/{report.total_stages})")
+```
+
+### Node.js / TypeScript
+```typescript
+import { Doctor, createContext } from '@ameva/runtime';
+
+const doc = new Doctor();
+const report = await doc.runSelfTest();
+console.log(`Vulkan GPU: ${report.deviceName}`);
+```
+
+---
+
+## Official Documentation & Benchmarks
+- [Official Architecture & API Reference](https://uno-km.vercel.app/lib/vulkan/)
+- [Ecosystem Metrics & Registry Stats](https://uno-km.vercel.app/foundation/metrics)
+- [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)).

ameva_runtime-2.5.0/README.pypi.md

@@ -0,0 +1,47 @@
+# AMEVA-Runtime (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/ameva-runtime.svg?style=flat-square&color=0369a1)](https://pypi.org/project/ameva-runtime/)
+[![Python](https://img.shields.io/pypi/pyversions/ameva-runtime.svg?style=flat-square)](https://pypi.org/project/ameva-runtime/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/ameva-runtime)
+
+> Next-Gen Unified On-Device Hardware Orchestration & 6-Modality AI Acceleration Runtime (with BitNet 1.58-bit Vulkan Compute) for Mobile & Edge
+
+## Installation
+
+```bash
+pip install ameva-runtime
+```
+
+## Quickstart
+
+```python
+import ameva_runtime as ameva
+from ameva_runtime import vulkan
+
+# Inspect hardware
+profile = ameva.detect_hardware()
+print(f"Target: {profile.soc_name} | {profile.gpu_vendor}")
+
+# Run diagnostics
+doc = vulkan.Doctor()
+report = doc.run_self_test()
+print(f"Passed: {report.passed_stages}/{report.total_stages}")
+```
+
+## Empirical Benchmarks
+
+- **Galaxy S25 (Adreno 830)**:
+  - BitNet 1.58-bit LLM: **17.558 t/s (12.58x speedup)**, Prompt Eval **205.9 ms**.
+  - Qwen2.5-0.5B LLM: **35.80 t/s** (25/25 VRAM layers).
+  - Whisper STT: **4,401 ms**, TTS: RTF **0.264x** (medium) / **0.993x** (high-fp16).
+- **Galaxy A35 (Mali-G68 MP5)**:
+  - BitNet 1.58-bit LLM: **3.471 t/s (5.94x speedup)**, Prompt Eval **1,552.8 ms**.
+  - Qwen2.5-0.5B LLM: **4.44 t/s** (+26.9% vs NEON).
+  - Whisper STT: **360.60s (2.26x speedup)**, TTS: RTF **1.146x**.
+
+## Documentation
+- [Official Documentation](https://uno-km.vercel.app/lib/vulkan/)
+- [GitHub Repository](https://github.com/uno-km/ameva-runtime)
+
+## License
+Apache-2.0 License. Copyright (c) 2026 Eunho Kim (@uno-km).

ameva_runtime-2.5.0/profiles/validated-vulkan-profiles.json

@@ -0,0 +1,214 @@
+{
+  "schema_version": "1.0.0",
+  "registry_name": "AMEVA Validated Vulkan Device Profiles",
+  "profiles": [
+    {
+      "model": "SM-A356N",
+      "codename": "a35x",
+      "market_name": "Samsung Galaxy A35 5G",
+      "soc": "Exynos 1380 (s5e8835)",
+      "gpu": "ARM Mali-G68 MP5",
+      "android_version": 16,
+      "api_level": 36,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 9.39369e-05,
+      "status": "VERIFIED_PRODUCTION",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128,
+      "enforce_medium_matmul": true
+    },
+    {
+      "model": "SM-A546N",
+      "codename": "a54x",
+      "market_name": "Samsung Galaxy A54 5G",
+      "soc": "Exynos 1380 (s5e8835)",
+      "gpu": "ARM Mali-G68 MP5",
+      "android_version": 14,
+      "api_level": 34,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 9.39369e-05,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-A356N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-M546B",
+      "codename": "m54x",
+      "market_name": "Samsung Galaxy M54 5G",
+      "soc": "Exynos 1380 (s5e8835)",
+      "gpu": "ARM Mali-G68 MP5",
+      "android_version": 14,
+      "api_level": 34,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 9.39369e-05,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-A356N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-A536N",
+      "codename": "a53x",
+      "market_name": "Samsung Galaxy A53 5G",
+      "soc": "Exynos 1280 (s5e8825)",
+      "gpu": "ARM Mali-G68 MP4",
+      "android_version": 14,
+      "api_level": 34,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 9.45e-05,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-A356N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-A336N",
+      "codename": "a33x",
+      "market_name": "Samsung Galaxy A33 5G",
+      "soc": "Exynos 1280 (s5e8825)",
+      "gpu": "ARM Mali-G68 MP4",
+      "android_version": 14,
+      "api_level": 34,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 9.45e-05,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-A356N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-G991N",
+      "codename": "o1s",
+      "market_name": "Samsung Galaxy S21 5G",
+      "soc": "Exynos 2100",
+      "gpu": "ARM Mali-G78 MP14",
+      "android_version": 15,
+      "api_level": 35,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 9.39e-05,
+      "status": "VERIFIED_PRODUCTION",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-G996N",
+      "codename": "t2s",
+      "market_name": "Samsung Galaxy S21+ 5G",
+      "soc": "Exynos 2100",
+      "gpu": "ARM Mali-G78 MP14",
+      "android_version": 15,
+      "api_level": 35,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 9.39e-05,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-G991N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-G998N",
+      "codename": "p3s",
+      "market_name": "Samsung Galaxy S21 Ultra 5G",
+      "soc": "Exynos 2100",
+      "gpu": "ARM Mali-G78 MP14",
+      "android_version": 15,
+      "api_level": 35,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 9.39e-05,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-G991N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-G981N",
+      "codename": "z3s",
+      "market_name": "Samsung Galaxy S20 5G (Exynos)",
+      "soc": "Exynos 990",
+      "gpu": "ARM Mali-G77 MP11",
+      "android_version": 13,
+      "api_level": 33,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 1.12e-04,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-G991N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-G986N",
+      "codename": "y2s",
+      "market_name": "Samsung Galaxy S20+ 5G (Exynos)",
+      "soc": "Exynos 990",
+      "gpu": "ARM Mali-G77 MP11",
+      "android_version": 13,
+      "api_level": 33,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 1.12e-04,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-G991N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-G988N",
+      "codename": "z3s",
+      "market_name": "Samsung Galaxy S20 Ultra 5G (Exynos)",
+      "soc": "Exynos 990",
+      "gpu": "ARM Mali-G77 MP11",
+      "android_version": 13,
+      "api_level": 33,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 1.12e-04,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-G991N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "memory_alignment_bytes": 128
+    },
+    {
+      "model": "SM-S931N",
+      "codename": "pa1q",
+      "market_name": "Samsung Galaxy S25",
+      "soc": "Qualcomm Snapdragon 8 Elite (SM8750)",
+      "gpu": "Qualcomm Adreno 830",
+      "android_version": 16,
+      "api_level": 36,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 1.24e-05,
+      "status": "VERIFIED_PRODUCTION",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "subgroup_control_bypass": true
+    },
+    {
+      "model": "SM-S928N",
+      "codename": "e3q",
+      "market_name": "Samsung Galaxy S24 Ultra",
+      "soc": "Qualcomm Snapdragon 8 Gen 3 (SM8650-AC)",
+      "gpu": "Qualcomm Adreno 750",
+      "android_version": 14,
+      "api_level": 34,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 1.35e-05,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-S931N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "subgroup_control_bypass": true
+    },
+    {
+      "model": "SM-S911N",
+      "codename": "dm1q",
+      "market_name": "Samsung Galaxy S23",
+      "soc": "Qualcomm Snapdragon 8 Gen 2 (SM8550-AC)",
+      "gpu": "Qualcomm Adreno 740",
+      "android_version": 14,
+      "api_level": 34,
+      "loader_path": "/system/lib64/libvulkan.so",
+      "v10_matmul_max_error": 1.40e-05,
+      "status": "VERIFIED_INHERITED",
+      "source_profile": "SM-S931N",
+      "active_modalities": ["stt", "diffusion", "vision", "bitnet", "llamacpp", "tts", "train"],
+      "subgroup_control_bypass": true
+    }
+  ]
+}

ameva_runtime-2.5.0/pyproject.toml

@@ -0,0 +1,136 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ameva-runtime"
+dynamic = ["version"]
+description = "Unified Next-Gen Hardware Orchestration & AI Acceleration Runtime for Mobile & Edge"
+
+readme = "README.pypi.md"
+requires-python = ">=3.8"
+license = { text = "Apache-2.0" }
+authors = [{ name = "Eunho Kim", email = "contact@uno-km.com" }]
+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"
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software 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",
+]
+
+[project.scripts]
+ameva = "ameva_runtime.cli:main"
+ameva-run = "ameva_runtime.cli:main"
+ameva-gpu = "ameva_runtime.cli:legacy_gpu_main"
+ameva-doctor = "ameva_runtime.cli:main"
+ameva-vulkan = "ameva_runtime.cli:main"
+
+[project.urls]
+Homepage = "https://uno-km.vercel.app/lib/vulkan/"
+Repository = "https://github.com/uno-km/ameva-runtime"
+Documentation = "https://uno-km.vercel.app/lib/vulkan/"
+
+[project.optional-dependencies]
+stt       = ["termux-stt>=1.2.0"]
+diffusion = ["termux-diffusion>=1.5.0"]
+bitnet    = ["termux-bitnet>=1.2.0"]
+llamacpp  = ["termux-llamacpp>=1.3.0"]
+tts       = ["termux-tts>=1.4.0"]
+vision    = ["termux-vision>=1.2.0"]
+all = [
+    "termux-stt>=1.2.0",
+    "termux-diffusion>=1.5.0",
+    "termux-bitnet>=1.2.0",
+    "termux-llamacpp>=1.3.0",
+    "termux-tts>=1.4.0",
+    "termux-vision>=1.2.0",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["python"]
+testpaths = ["python/tests"]
+
+[tool.setuptools]
+package-dir = {"" = "python"}
+
+[tool.setuptools.packages.find]
+where = ["python"]
+include = ["ameva_runtime*"]
+exclude = ["tests*", "*tests*"]
+
+[tool.setuptools.dynamic]
+version = {attr = "ameva_runtime._version.__version__"}
+
+
+
+
+[tool.setuptools.package-data]
+"ameva_runtime" = [
+    "py.typed",
+]
+"ameva_runtime.vulkan" = [
+    "profiles/*.json",
+    "lib/*.so",
+    "lib/*.dll",
+    "py.typed",
+]