Metadata-Version: 2.4
Name: ameva-vulkan-runtime
Version: 1.1.0
Summary: Unified Cross-Modal Vulkan GPU Acceleration Runtime & HAL for Mobile Android
Home-page: https://uno-km.vercel.app/lib/vulkan/
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-vulkan-runtime
Project-URL: Documentation, https://uno-km.vercel.app/lib/vulkan/
Keywords: vulkan,gpu,android,termux,acceleration,adreno,mali,hal,ameva
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
Provides-Extra: stt
Requires-Dist: termux-stt>=1.1.1; extra == "stt"
Provides-Extra: diffusion
Requires-Dist: termux-diffusion>=1.3.1; extra == "diffusion"
Provides-Extra: bitnet
Requires-Dist: termux-bitnet>=1.0.0; extra == "bitnet"
Provides-Extra: llamacpp
Requires-Dist: termux-llamacpp>=1.0.0; extra == "llamacpp"
Provides-Extra: tts
Requires-Dist: termux-tts>=1.0.0; extra == "tts"
Provides-Extra: vision
Requires-Dist: termux-vision>=1.0.0; extra == "vision"
Provides-Extra: all
Requires-Dist: termux-stt>=1.1.1; extra == "all"
Requires-Dist: termux-diffusion>=1.3.1; extra == "all"
Requires-Dist: termux-bitnet>=1.0.0; extra == "all"
Requires-Dist: termux-llamacpp>=1.0.0; extra == "all"
Requires-Dist: termux-tts>=1.0.0; extra == "all"
Requires-Dist: termux-vision>=1.0.0; extra == "all"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# AMEVA-Vulkan-Runtime (Python)

[![PyPI](https://img.shields.io/pypi/v/ameva-vulkan-runtime.svg?style=flat-square&color=0369a1)](https://pypi.org/project/ameva-vulkan-runtime/)
[![Python](https://img.shields.io/pypi/pyversions/ameva-vulkan-runtime.svg?style=flat-square)](https://pypi.org/project/ameva-vulkan-runtime/)
[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/ameva-vulkan-runtime)

> **안드로이드 모바일 환경을 위한 통합 크로스 모달 Vulkan GPU 가속 런타임 및 하드웨어 추상화 계층(HAL)**  
> *Unified Cross-Modal Vulkan GPU Acceleration Runtime & HAL for Mobile Android*

## Installation

```bash
pip install ameva-vulkan-runtime
```

## Quickstart

```python
import ameva_vulkan_runtime as avr

doctor = avr.Doctor()
report = doctor.run_self_test(verbose=True)
print(f"Backend: {report.recommended_backend}, Device: {report.device_name}")

ctx = avr.create_context(device="auto", memory_limit_mb=1024)
print(f"Context active: {ctx.is_active}, Backend: {ctx.backend_type}")
```

## Description
Provides a single, zero-hardcoded C++20 Vulkan Hardware Abstraction Layer (HAL) and universal runtime for STT, Vision, LLM, Diffusion, and Training with a granular 12-stage validation hierarchy (V0-V11) and zero-data-loss auto-recovery.

## Documentation
- [Official Documentation & API Reference](https://uno-km.vercel.app/lib/ameva-vulkan-runtime/)
- [GitHub Repository](https://github.com/uno-km/ameva-vulkan-runtime)

## License
Apache-2.0 License. Copyright (c) 2026 Eunho Kim (@uno-km).
