Metadata-Version: 2.4
Name: suzune-flash
Version: 0.1.0
Summary: Flagship Multilingual On-Device Neural Voice Engine by Sorika Labs
Author-email: Sorika Labs <contact@sorikalabs.com>
Project-URL: Homepage, https://huggingface.co/sorika-labs/suzune-s1-flash
Project-URL: Repository, https://huggingface.co/sorika-labs/suzune-s1-flash
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: torch>=2.0.0
Requires-Dist: transformers>=4.40.0
Requires-Dist: huggingface_hub>=0.20.0
Requires-Dist: soundfile>=0.12.0
Requires-Dist: numpy
Requires-Dist: loguru
Requires-Dist: misaki>=0.7.0
Requires-Dist: num2words

# ⚡ Suzune Flash (82M Flagship Multilingual Edge TTS)

[![PyPI](https://img.shields.io/badge/pypi-suzune--flash-blue.svg)](https://pypi.org/project/suzune-flash/)
[![Hugging Face](https://img.shields.io/badge/HF%20Model-sorika--labs%2Fsuzune--s1--flash-yellow)](https://huggingface.co/sorika-labs/suzune-s1-flash)
[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](LICENSE)

**Suzune Flash** is an 82-million parameter studio-grade multilingual Text-to-Speech (TTS) foundation model engineered by **Sorika Labs**.

Designed for real-time edge intelligence, Suzune Flash produces broadcast-quality speech with sub-25ms latency on CPUs, Apple Silicon (M1/M2/M3), and GPUs, featuring native English and Hindi studio voices.

---

## 🏛️ Base Model & Lineage

> **Lineage & Attribution**:
> Suzune S1 Flash is developed and released by **Sorika Labs**. The model architecture is adapted and fine-tuned from the open-source [`hexgrad/Kokoro-82M`](https://huggingface.co/hexgrad/Kokoro-82M) and StyleTTS2 foundation (released under Apache 2.0).
>
> **Sorika Labs Enhancements & Customizations**:
> 1. **Signature Studio Voices**: Specially trained and calibrated flagship voices (`ira`, `kian`, `kagami`, `phi`).
> 2. **Dedicated Hindi Studio Voices**: Native Indian speech synthesis with studio voices (`ananya`, `aarav`, `priya`, `rohan`).
> 3. **Built-in Pure Python Devanagari G2P**: Zero-dependency grapheme-to-phoneme engine for pure Hindi Devanagari text (`नमस्ते! यह सोज़ूने है...`) — works universally across Windows, macOS, Linux, Kaggle, and Colab with **zero** external C-libraries like `espeak-ng`.
> 4. **Native ONNX Quantized Engine**: Up to 5x faster CPU inference via companion repository [`sorika-labs/suzune-s1-flash-gguf`](https://huggingface.co/sorika-labs/suzune-s1-flash-gguf).
> 5. **Unified SDK**: High-level `suzune-flash` Python runtime with streaming, multi-voice interpolation, and CLI.

---

## 🚀 Quick Install

```bash
pip install suzune-flash
```

---

## 🎙️ Python Quickstart

### 1. English Studio Speech

```python
import suzune_flash

# Load Suzune Flash (default signature voice: 'ira')
tts = suzune_flash.load(voice="ira", device="cpu")

audio, sr = tts.speak(
    "Hello! This is Suzune Flash by Sorika Labs, delivering breathtaking studio quality speech.",
    output="english_studio.wav"
)
```

### 2. Native Hindi Studio Speech

```python
import suzune_flash

# Load native Hindi female voice 'ananya' or male voice 'aarav'
tts = suzune_flash.load(voice="ananya", device="cpu")

hindi_text = "नमस्ते! यह सोज़ूने फ़्लैश है, जिसे सोरिका लैब्स द्वारा विकसित किया गया है।"
audio, sr = tts.speak(hindi_text, output="hindi_studio.wav")
```

### 3. Fast Quantized ONNX Mode (CPU)

```python
import suzune_flash

# Up to 5x faster CPU inference via Q8 ONNX
tts = suzune_flash.load(engine="onnx", quant="q8", voice="ira")
audio, sr = tts.speak("Running fast quantized ONNX speech on CPU.", output="fast.wav")
```

---

## 🎭 Available Voices

| Category | Voices |
| :--- | :--- |
| **Sorika Signature** | `ira`, `kian`, `kagami`, `phi` |
| **Hindi Studio** | `ananya` (F), `aarav` (M), `priya` (F), `rohan` (M) |
| **International** | `emma_british_f`, `george_british_m`, `chloe_french_f`, `camila_portuguese_f`, `giulia_italian_f`, `mateo_spanish_m`, `sofia_spanish_f` |

---

## 💻 Terminal Command Line (CLI)

```bash
suzune-flash "Hello from Sorika Labs on-device AI!" --voice ira --output output.wav
```

---

## 📜 License & Citation

Licensed under the **Apache 2.0 License**.

```bibtex
@misc{sorika2026suzuneflash,
  author = {Sorika Labs},
  title = {Suzune S1 Flash: Flagship Multilingual On-Device Neural Speech Foundation Model},
  year = {2026},
  publisher = {Hugging Face},
  journal = {Hugging Face repository},
  howpublished = {https://huggingface.co/sorika-labs/suzune-s1-flash}
}
```
