melek-voice 2.0.0__tar.gz

melek-voice-2.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+recursive-include melek_voice/assets *.json
+recursive-exclude melek_voice/assets/onnx *
+recursive-exclude tests *

melek-voice-2.0.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.1
+Name: melek-voice
+Version: 2.0.0
+Summary: melek-voice (Meleğin Ses Telleri) - Yüksek Performanslı Türkçe Nöral Ses Sentezleyici
+Home-page: https://github.com/TearsFearsxf/melek-voice
+Author: Melek AI Development
+Author-email: Melek AI Development <developer@melek.ai>
+License: MIT
+Project-URL: Homepage, https://github.com/TearsFearsxf/melek-voice
+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: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# melek-voice (Meleğin Ses Telleri) 2.0.0
+
+Melek Yapay Zeka Asistanı için geliştirilmiş yüksek performanslı, stüdyo kalitesinde Türkçe nöral ses sentezleme (Text-to-Speech / TTS) ve kesilebilir ses oynatma kütüphanesidir.
+
+Supertone'un **Flow Matching (Supertonic 3)** mimarisi üzerine inşa edilmiştir. %100 yerel ve çevrimdışı (offline) çalışır, internete bağımlı değildir.
+
+---
+
+## Öne Çıkan Özellikler (v2.0.0)
+
+* **44.1 kHz Stüdyo Kalitesi:** `44100 Hz` örnekleme hızı ve `228` Mel-filtre bankası ile insan doğallığında, dolgun ve pürüzsüz Türkçe telaffuz.
+* **4 Kat Hızlı & Optimize Sentez (RTF ~0.26x):** Önceki versiyondaki 32 adım yerine kalibre edilen 8 adım ile CPU üzerinde 4 saniyelik konuşmayı ~1.0 saniyede üretir.
+* **Bellek İçi (In-Memory) Oynatma:** Sesi geçici diske yazmadan doğrudan RAM üzerinden `pygame.mixer` ile çalar. Sıfır disk gecikmesi ve aşınması.
+* **İnteraktif Araya Girme & Susturma (Barge-in):** `stop()`, `pause()`, `resume()`, `clear_queue()` ve `is_speaking` fonksiyonları ile kullanıcı Melek'in sözünü anında kesebilir.
+* **Cümle Bazlı Streaming Pipelining:** Uzun paragrafları cümlelere bölüp ilk cümleyi anında (~300ms) başlatır; birinci cümle çalarken ikinci cümle arka planda sentezlenir.
+* **Akıllı Model Çözücü (Smart Model Resolver):** 398 MB'lık büyük ağırlıkları paketten ayırarak hafif PyPI paketi sunar. Modelleri yerel klasörden veya kullanıcı önbelleğinden (`~/.cache/supertonic3`) anında yükler; yoksa HuggingFace'ten otomatik çeker.
+* **LRU Ses Önbelleği:** Sık söylenen cümleleri RAM ve diskte önbelleğe alır, disk boyutunu otomatik sınırlar (varsayılan max 50 MB).
+
+---
+
+## Kurulum
+
+```bash
+pip install melek-voice
+```
+
+Gerekli bağımlılıklar:
+* `supertonic`
+* `pygame`
+* `soundfile`
+* `numpy`
+
+---
+
+## Hızlı Başlangıç
+
+### 1. Temel Kullanım
+
+```python
+from melek_voice import MelekVoice
+
+# Varsayılan 'dengeli' (F5 Melek tonu) ile başlat
+voice = MelekVoice()
+
+# Arka planda asenkron konuşur
+voice.speak("Merhaba, ben Melek. Size nasıl yardımcı olabilirim?")
+
+# Konuşmanın bitmesini bekle
+voice.wait_until_done()
+```
+
+### 2. Senkron Konuşma (`block=True`)
+
+```python
+# Ses tamamen bitene kadar program akışını bekletir
+voice.speak("Sistem başarıyla güncellendi efendim.", block=True)
+print("Bu satır ancak ses bittikten sonra çalışır.")
+```
+
+### 3. Cümle Streaming Pipelining (`pipeline=True`)
+
+Uzun bir yanıt verirken tüm paragrafın sentezlenmesini beklemeden ilk cümleyi hemen başlatmak için:
+
+```python
+metin = (
+    "Bugün hava İstanbul'da 22 derece ve güneşli. "
+    "Öğleden sonra hafif rüzgar bekleniyor. "
+    "Planlanan 3 adet hatırlatıcınız bulunuyor efendim."
+)
+
+# İlk cümle ~300 milisaniyede çalmaya başlar!
+voice.speak(metin, pipeline=True, block=True)
+```
+
+### 4. Konuşmayı Kesme (Barge-in / Stop)
+
+```python
+# Melek konuşurken anında sustur ve bekleyen kuyruğu temizle:
+voice.stop()
+
+# Veya duraklat / devam ettir:
+voice.pause()
+voice.resume()
+```
+
+### 5. Ses Stilleri ve Presetler
+
+```python
+# Hazır kadınsı ve erkeksi presetler:
+voice.set_style("hizli")    # 5 Adım - Ultra hızlı tepki
+voice.set_style("dengeli")  # 8 Adım - Doğal ve pürüzsüz Melek tonu (Varsayılan)
+voice.set_style("sicak")    # 8 Adım - Samimi ve dostane tonlama
+voice.set_style("zarif")    # 10 Adım - Sakin ve feminen akış
+voice.set_style("derin")    # 12 Adım - Stüdyo kalitesinde maksimum netlik
+
+# Erkek sesleri:
+voice.set_style("erkek_dengeli")
+voice.set_style("erkek_derin")
+```
+
+### 6. Dosyaya veya Baytlara Dönüştürme
+
+```python
+# Doğrudan WAV dosyasına kaydet
+voice.save_to_file("Bu ses diske kaydedildi.", "cikti.wav")
+
+# WAV baytlarını bellekten al (Web API / GUI için)
+wav_bytes, duration = voice.synthesize_bytes("API üzerinden dönecek ses.")
+```
+
+---
+
+## Lisans
+
+MIT License. Melek AI Projesi.

melek-voice-2.0.0/README.md

@@ -0,0 +1,115 @@
+# melek-voice (Meleğin Ses Telleri) 2.0.0
+
+Melek Yapay Zeka Asistanı için geliştirilmiş yüksek performanslı, stüdyo kalitesinde Türkçe nöral ses sentezleme (Text-to-Speech / TTS) ve kesilebilir ses oynatma kütüphanesidir.
+
+Supertone'un **Flow Matching (Supertonic 3)** mimarisi üzerine inşa edilmiştir. %100 yerel ve çevrimdışı (offline) çalışır, internete bağımlı değildir.
+
+---
+
+## Öne Çıkan Özellikler (v2.0.0)
+
+* **44.1 kHz Stüdyo Kalitesi:** `44100 Hz` örnekleme hızı ve `228` Mel-filtre bankası ile insan doğallığında, dolgun ve pürüzsüz Türkçe telaffuz.
+* **4 Kat Hızlı & Optimize Sentez (RTF ~0.26x):** Önceki versiyondaki 32 adım yerine kalibre edilen 8 adım ile CPU üzerinde 4 saniyelik konuşmayı ~1.0 saniyede üretir.
+* **Bellek İçi (In-Memory) Oynatma:** Sesi geçici diske yazmadan doğrudan RAM üzerinden `pygame.mixer` ile çalar. Sıfır disk gecikmesi ve aşınması.
+* **İnteraktif Araya Girme & Susturma (Barge-in):** `stop()`, `pause()`, `resume()`, `clear_queue()` ve `is_speaking` fonksiyonları ile kullanıcı Melek'in sözünü anında kesebilir.
+* **Cümle Bazlı Streaming Pipelining:** Uzun paragrafları cümlelere bölüp ilk cümleyi anında (~300ms) başlatır; birinci cümle çalarken ikinci cümle arka planda sentezlenir.
+* **Akıllı Model Çözücü (Smart Model Resolver):** 398 MB'lık büyük ağırlıkları paketten ayırarak hafif PyPI paketi sunar. Modelleri yerel klasörden veya kullanıcı önbelleğinden (`~/.cache/supertonic3`) anında yükler; yoksa HuggingFace'ten otomatik çeker.
+* **LRU Ses Önbelleği:** Sık söylenen cümleleri RAM ve diskte önbelleğe alır, disk boyutunu otomatik sınırlar (varsayılan max 50 MB).
+
+---
+
+## Kurulum
+
+```bash
+pip install melek-voice
+```
+
+Gerekli bağımlılıklar:
+* `supertonic`
+* `pygame`
+* `soundfile`
+* `numpy`
+
+---
+
+## Hızlı Başlangıç
+
+### 1. Temel Kullanım
+
+```python
+from melek_voice import MelekVoice
+
+# Varsayılan 'dengeli' (F5 Melek tonu) ile başlat
+voice = MelekVoice()
+
+# Arka planda asenkron konuşur
+voice.speak("Merhaba, ben Melek. Size nasıl yardımcı olabilirim?")
+
+# Konuşmanın bitmesini bekle
+voice.wait_until_done()
+```
+
+### 2. Senkron Konuşma (`block=True`)
+
+```python
+# Ses tamamen bitene kadar program akışını bekletir
+voice.speak("Sistem başarıyla güncellendi efendim.", block=True)
+print("Bu satır ancak ses bittikten sonra çalışır.")
+```
+
+### 3. Cümle Streaming Pipelining (`pipeline=True`)
+
+Uzun bir yanıt verirken tüm paragrafın sentezlenmesini beklemeden ilk cümleyi hemen başlatmak için:
+
+```python
+metin = (
+    "Bugün hava İstanbul'da 22 derece ve güneşli. "
+    "Öğleden sonra hafif rüzgar bekleniyor. "
+    "Planlanan 3 adet hatırlatıcınız bulunuyor efendim."
+)
+
+# İlk cümle ~300 milisaniyede çalmaya başlar!
+voice.speak(metin, pipeline=True, block=True)
+```
+
+### 4. Konuşmayı Kesme (Barge-in / Stop)
+
+```python
+# Melek konuşurken anında sustur ve bekleyen kuyruğu temizle:
+voice.stop()
+
+# Veya duraklat / devam ettir:
+voice.pause()
+voice.resume()
+```
+
+### 5. Ses Stilleri ve Presetler
+
+```python
+# Hazır kadınsı ve erkeksi presetler:
+voice.set_style("hizli")    # 5 Adım - Ultra hızlı tepki
+voice.set_style("dengeli")  # 8 Adım - Doğal ve pürüzsüz Melek tonu (Varsayılan)
+voice.set_style("sicak")    # 8 Adım - Samimi ve dostane tonlama
+voice.set_style("zarif")    # 10 Adım - Sakin ve feminen akış
+voice.set_style("derin")    # 12 Adım - Stüdyo kalitesinde maksimum netlik
+
+# Erkek sesleri:
+voice.set_style("erkek_dengeli")
+voice.set_style("erkek_derin")
+```
+
+### 6. Dosyaya veya Baytlara Dönüştürme
+
+```python
+# Doğrudan WAV dosyasına kaydet
+voice.save_to_file("Bu ses diske kaydedildi.", "cikti.wav")
+
+# WAV baytlarını bellekten al (Web API / GUI için)
+wav_bytes, duration = voice.synthesize_bytes("API üzerinden dönecek ses.")
+```
+
+---
+
+## Lisans
+
+MIT License. Melek AI Projesi.

melek-voice-2.0.0/melek_voice/__init__.py

@@ -0,0 +1,19 @@
+"""
+melek-voice (Meleğin Ses Telleri) - Melek AI Ses Sentezleyici & Oynatıcı.
+"""
+
+from .engine import MelekVoice
+from .presets import PRESETS, DEFAULT_PRESET, SAMPLE_RATE, split_sentences
+from .cache import AudioCache
+from .resolver import resolve_model_path
+
+__version__ = "2.0.0"
+__all__ = [
+    "MelekVoice",
+    "PRESETS",
+    "DEFAULT_PRESET",
+    "SAMPLE_RATE",
+    "split_sentences",
+    "AudioCache",
+    "resolve_model_path",
+]

melek-voice-2.0.0/melek_voice/assets/config.json

@@ -0,0 +1,5 @@
+{
+  "model_name": "Supertonic 3",
+  "model_type": "onnx",
+  "description": "This is a stub config for Hugging Face download counting. The actual model is located at onnx/"
+}