Metadata-Version: 2.4
Name: termux-tts
Version: 1.1.5
Summary: On-device Text-to-Speech framework utilizing device resources (DSP Formant Vocoder, ONNX Neural Runtime & Android Native Voice Bridge)
Home-page: https://github.com/uno-km/termux-tts
Author: AMEVA Foundation
Author-email: AOSF / uno-km <zhfldk014745@naver.com>
License: Apache-2.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20.0
Requires-Dist: ameva-component-sdk<2.0,>=0.1.0
Provides-Extra: onnx
Requires-Dist: onnxruntime>=1.15.0; extra == "onnx"
Provides-Extra: neural
Requires-Dist: onnxruntime>=1.15.0; extra == "neural"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: paramiko>=3.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Termux-TTS (Python)

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

> **High-Performance Multi-Backend Speech Synthesis Framework for Android Termux & Edge Linux**  
> Supports Zero-Dependency Parametric DSP Formant Vocoder, Deep Learning ONNX Neural Runtime, and Android Native System Voice Bridge.

## Installation

```bash
pip install termux-tts
```

## Quickstart

```python
import termux_tts as tts

# 1. Zero-Dependency DSP Formant Mode (Default)
with tts.load(engine="dsp", language="ko") as engine:
    res = engine.synthesize("안녕하세요, 텀묵스 음성 합성입니다.", output="dsp.wav")
    print(f"Synthesized in {res.elapsed_ms:.1f}ms (RTF: {res.rtf:.4f}x)")

# 2. Deep Learning ONNX Mode
with tts.load(engine="onnx", model="vits_ko.onnx", language="ko") as engine:
    res = engine.synthesize("신경망 고품질 음성 합성입니다.", output="onnx.wav")

# 3. Android System Native Speak Mode
with tts.load(engine="native", language="ko") as engine:
    engine.speak("스피커로 즉시 발화합니다.")
```

## Features
- **Zero-Dependency DSP Engine**: Instant CPU execution with 0MB download overhead (Rosenberg Glottal Pulse + 5-Band Biquad Filters).
- **Authentic ONNX Neural Runtime**: Deep learning acoustic model execution for VITS, Piper, and FastSpeech ONNX models.
- **Android Native Bridge**: Direct speaker speech playback via Termux IPC.
- **Cross-Platform CLI & Node.js Binding**: First-class support for Python, npm, and shell scripts.

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

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

