abstractvoice 0.3.0__py3-none-any.whl → 0.4.1__py3-none-any.whl

{abstractvoice-0.3.0.dist-info → abstractvoice-0.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractvoice
-Version: 0.3.0
+Version: 0.4.1
 Summary: A modular Python library for voice interactions with AI systems
 Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
 License-Expression: MIT
@@ -29,7 +29,7 @@ Requires-Dist: coqui-tts<0.30.0,>=0.27.0; extra == "tts"
 Requires-Dist: torch<2.4.0,>=2.0.0; extra == "tts"
 Requires-Dist: torchvision<0.19.0,>=0.15.0; extra == "tts"
 Requires-Dist: torchaudio<2.4.0,>=2.0.0; extra == "tts"
-Requires-Dist: librosa<0.11.0,>=0.10.0; extra == "tts"
+Requires-Dist: librosa>=0.10.0; extra == "tts"
 Provides-Extra: stt
 Requires-Dist: openai-whisper>=20230314; extra == "stt"
 Requires-Dist: tiktoken>=0.6.0; extra == "stt"
@@ -44,7 +44,7 @@ Requires-Dist: coqui-tts<0.30.0,>=0.27.0; extra == "all"
 Requires-Dist: torch<2.4.0,>=2.0.0; extra == "all"
 Requires-Dist: torchvision<0.19.0,>=0.15.0; extra == "all"
 Requires-Dist: torchaudio<2.4.0,>=2.0.0; extra == "all"
-Requires-Dist: librosa<0.11.0,>=0.10.0; extra == "all"
+Requires-Dist: librosa>=0.10.0; extra == "all"
 Requires-Dist: soundfile>=0.12.1; extra == "all"
 Requires-Dist: flask>=2.0.0; extra == "all"
 Requires-Dist: tiktoken>=0.6.0; extra == "all"
@@ -61,7 +61,7 @@ Requires-Dist: coqui-tts<0.30.0,>=0.27.0; extra == "voice-full"
 Requires-Dist: torch<2.4.0,>=2.0.0; extra == "voice-full"
 Requires-Dist: torchvision<0.19.0,>=0.15.0; extra == "voice-full"
 Requires-Dist: torchaudio<2.4.0,>=2.0.0; extra == "voice-full"
-Requires-Dist: librosa<0.11.0,>=0.10.0; extra == "voice-full"
+Requires-Dist: librosa>=0.10.0; extra == "voice-full"
 Requires-Dist: soundfile>=0.12.1; extra == "voice-full"
 Requires-Dist: tiktoken>=0.6.0; extra == "voice-full"
 Provides-Extra: core-tts
@@ -69,7 +69,7 @@ Requires-Dist: coqui-tts<0.30.0,>=0.27.0; extra == "core-tts"
 Requires-Dist: torch<2.4.0,>=2.0.0; extra == "core-tts"
 Requires-Dist: torchvision<0.19.0,>=0.15.0; extra == "core-tts"
 Requires-Dist: torchaudio<2.4.0,>=2.0.0; extra == "core-tts"
-Requires-Dist: librosa<0.11.0,>=0.10.0; extra == "core-tts"
+Requires-Dist: librosa>=0.10.0; extra == "core-tts"
 Provides-Extra: core-stt
 Requires-Dist: openai-whisper>=20230314; extra == "core-stt"
 Requires-Dist: tiktoken>=0.6.0; extra == "core-stt"
@@ -164,34 +164,58 @@ AbstractVoice automatically detects espeak-ng and upgrades to premium quality vo
 
 ## Quick Start
 
-### Basic Usage (Minimal Installation)
+### ⚡ Instant TTS (v0.4.0+)
 
 ```python
-# First install with minimal dependencies
-# pip install abstractvoice
-
 from abstractvoice import VoiceManager
 
-# This will show a helpful error message with installation instructions
-try:
-    vm = VoiceManager()
-except ImportError as e:
-    print(e)  # Shows: "TTS functionality requires optional dependencies..."
-    # Follow the instructions to install: pip install abstractvoice[all]
+# Initialize voice manager - automatically downloads essential model if needed
+vm = VoiceManager()
+
+# Text-to-speech works immediately!
+vm.speak("Hello! TTS works out of the box!")
 ```
 
-### Full Usage Example
+**That's it!** AbstractVoice v0.4.0+ automatically:
+- ✅ Downloads essential English model (107MB) on first use
+- ✅ Caches models permanently for offline use
+- ✅ Works immediately after first setup
+- ✅ No complex configuration needed
 
-```python
-# After installing with: pip install abstractvoice[all]
+### 🌍 Multi-Language Support
 
-from abstractvoice import VoiceManager
+```python
+# Download and use French voice
+vm.download_model('fr.css10_vits')  # Downloads automatically
+vm.set_language('fr')
+vm.speak("Bonjour! Je parle français maintenant.")
+
+# Download and use German voice
+vm.download_model('de.thorsten_vits')
+vm.set_language('de')
+vm.speak("Hallo! Ich spreche jetzt Deutsch.")
+```
 
-# Initialize voice manager
-vm = VoiceManager(language='en', debug_mode=True)
+### 🔧 Check System Status
 
-# Text-to-speech
-vm.speak("Hello! I can speak text and listen for responses.")
+```python
+from abstractvoice import is_ready, get_status, list_models
+import json
+
+# Quick readiness check
+ready = is_ready()
+print(f"TTS ready: {ready}")
+
+# Get detailed status
+status = json.loads(get_status())
+print(f"Models cached: {status['total_cached']}")
+print(f"Offline ready: {status['ready_for_offline']}")
+
+# List all available models
+models = json.loads(list_models())
+for lang, voices in models.items():
+    print(f"{lang}: {len(voices)} voices available")
+```
 
 # Speech-to-text with callbacks
 def on_transcription(text):
@@ -1289,6 +1313,80 @@ voice_manager.listen(
 )
 ```
 
+## 💻 CLI Commands (v0.4.0+)
+
+AbstractVoice provides powerful CLI commands for model management and voice interactions.
+
+### Model Management
+
+```bash
+# Download essential model for offline use (recommended first step)
+abstractvoice download-models
+
+# Download models for specific languages
+abstractvoice download-models --language fr    # French
+abstractvoice download-models --language de    # German
+abstractvoice download-models --language it    # Italian
+abstractvoice download-models --language es    # Spanish
+
+# Download specific model by name
+abstractvoice download-models --model tts_models/fr/css10/vits
+
+# Download all available models (large download!)
+abstractvoice download-models --all
+
+# Check current cache status
+abstractvoice download-models --status
+
+# Clear model cache
+abstractvoice download-models --clear
+```
+
+### Voice Interface
+
+```bash
+# Start voice interface (default)
+abstractvoice
+
+# Start CLI REPL with specific language
+abstractvoice cli --language fr
+
+# Start with specific model
+abstractvoice --model granite3.3:2b --language de
+
+# Run simple example
+abstractvoice simple
+
+# Check dependencies
+abstractvoice check-deps
+```
+
+### CLI Voice Commands
+
+In the CLI REPL, use these commands:
+
+```bash
+# List all available voices with download status
+/setvoice
+
+# Download and set specific voice
+/setvoice fr.css10_vits      # French CSS10 VITS
+/setvoice de.thorsten_vits   # German Thorsten
+/setvoice it.mai_male_vits   # Italian Male
+
+# Change language
+/language fr
+/language de
+
+# Voice controls
+/pause                       # Pause current speech
+/resume                      # Resume speech
+/stop                        # Stop speech
+
+# Exit
+/exit
+```
+
 ## Perspectives
 
 This is a test project that I designed with examples to work with Ollama, but I will adapt the examples and abstractvoice to work with any LLM provider (anthropic, openai, etc).

abstractvoice-0.4.1.dist-info/RECORD

@@ -0,0 +1,23 @@
+abstractvoice/__init__.py,sha256=HZYSCQ-xztoj7gWr5dVLBsGh4AYrViTYe8-ze4b-ynY,1011
+abstractvoice/__main__.py,sha256=e6jhoONg3uwwPUCdnr68bSRTT1RrpWy2DrOJ6ozMJVc,4775
+abstractvoice/dependency_check.py,sha256=BUUADz4un4_FCZzNpgwk1qpJ6yqVi5Pvjfd3JLS8hAI,10045
+abstractvoice/model_manager.py,sha256=hnN3PTaY109mjTjgBuOB8yfAYVlMpqtMVBljLASRUi4,14275
+abstractvoice/recognition.py,sha256=4KtDUDFixEYuBUMDH2fWaD9csKlwA9tqXkMAkyQMSMo,11259
+abstractvoice/simple_model_manager.py,sha256=DTvEBEPtfu9zJA6V3S8SaWQ_pDYFlK_SoOMlnnRjBtk,13801
+abstractvoice/voice_manager.py,sha256=n7QHZPR1LWh3RjEBQ3LVrBKoOr5zccc3soKah5CBrac,32584
+abstractvoice/examples/__init__.py,sha256=94vpKJDlfOrEBIUETg-57Q5Z7fYDidg6v4UzV7V_lZA,60
+abstractvoice/examples/cli_repl.py,sha256=kIgvgrGfyejX8-VFeFhvAVqrp3X-s-K3Ul861aM4Bh8,44220
+abstractvoice/examples/voice_cli.py,sha256=SYnFkz9KWWTISLgS2beJzb2tzLoz4dXpHQBWpKgS0sc,11585
+abstractvoice/examples/web_api.py,sha256=0g5LKJpl7fZepPQJL25AcdaevV-xv34VqqyWGYYchPk,6376
+abstractvoice/stt/__init__.py,sha256=PFc6la3tTkxT4TJYwb0PnMIahM_hFtU4pNQdeKmbooo,120
+abstractvoice/stt/transcriber.py,sha256=GdaH1OsCHu4Vu9rUsQlzH6X9bfcnoiK5tGz1AW_uj6Q,5481
+abstractvoice/tts/__init__.py,sha256=WgJrxqdc_qaRyfFt1jbgMQD9S757jYuBpDzMRB02TFs,122
+abstractvoice/tts/tts_engine.py,sha256=HstJMwxTbZJx87Q-CY4mWeKHKbj17DhdvDdlch3xUNQ,49725
+abstractvoice/vad/__init__.py,sha256=RIIbFw25jNHgel06E4VvTWJnXjwjeFZ98m1Vx9hVjuo,119
+abstractvoice/vad/voice_detector.py,sha256=ghrhpDFlIR5TsMB2gpigXY6t5c_1yZ7vEX1imAMgWjc,3166
+abstractvoice-0.4.1.dist-info/licenses/LICENSE,sha256=TiDPM5WcFRQPoC5e46jGMeMppZ-eu0eFx_HytjE49bk,1105
+abstractvoice-0.4.1.dist-info/METADATA,sha256=AN_KjRcI2ZaetOIuAb9JOf4dvFWJI7AckQpV25wq2tI,40713
+abstractvoice-0.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+abstractvoice-0.4.1.dist-info/entry_points.txt,sha256=3bDX2dNOGvrsTx1wZ_o_hVgmM_a2zbcHc1ZkL154rN4,72
+abstractvoice-0.4.1.dist-info/top_level.txt,sha256=a1qyxqgF1O8cJtPKpcJuImGZ_uXqPNghbLZ9gp-UiOo,14
+abstractvoice-0.4.1.dist-info/RECORD,,

abstractvoice-0.3.0.dist-info/RECORD

@@ -1,21 +0,0 @@
-abstractvoice/__init__.py,sha256=6GWG6ruCOQ73dOK1-lGB4F8fvjoAtsAP8fIoYCnVuZk,817
-abstractvoice/__main__.py,sha256=e6jhoONg3uwwPUCdnr68bSRTT1RrpWy2DrOJ6ozMJVc,4775
-abstractvoice/dependency_check.py,sha256=BUUADz4un4_FCZzNpgwk1qpJ6yqVi5Pvjfd3JLS8hAI,10045
-abstractvoice/recognition.py,sha256=4KtDUDFixEYuBUMDH2fWaD9csKlwA9tqXkMAkyQMSMo,11259
-abstractvoice/voice_manager.py,sha256=WYuN949pzf4pw8SE3g40OQZNC1CbgUZ5SzvpAGAIfPI,29995
-abstractvoice/examples/__init__.py,sha256=94vpKJDlfOrEBIUETg-57Q5Z7fYDidg6v4UzV7V_lZA,60
-abstractvoice/examples/cli_repl.py,sha256=39KO2zbQCG3bkuzrMEp1txLherw2rU4aGG2KTUHBYW0,42636
-abstractvoice/examples/voice_cli.py,sha256=oliUPUZUPR6HaVaOtn-vAM-Loq3PDqkP34w-X3xxzbY,9702
-abstractvoice/examples/web_api.py,sha256=0g5LKJpl7fZepPQJL25AcdaevV-xv34VqqyWGYYchPk,6376
-abstractvoice/stt/__init__.py,sha256=PFc6la3tTkxT4TJYwb0PnMIahM_hFtU4pNQdeKmbooo,120
-abstractvoice/stt/transcriber.py,sha256=GdaH1OsCHu4Vu9rUsQlzH6X9bfcnoiK5tGz1AW_uj6Q,5481
-abstractvoice/tts/__init__.py,sha256=WgJrxqdc_qaRyfFt1jbgMQD9S757jYuBpDzMRB02TFs,122
-abstractvoice/tts/tts_engine.py,sha256=9CZAZITZ_VNZs0grwsqWIFj3aUsHvrWeFVV66lH_Bf8,44926
-abstractvoice/vad/__init__.py,sha256=RIIbFw25jNHgel06E4VvTWJnXjwjeFZ98m1Vx9hVjuo,119
-abstractvoice/vad/voice_detector.py,sha256=ghrhpDFlIR5TsMB2gpigXY6t5c_1yZ7vEX1imAMgWjc,3166
-abstractvoice-0.3.0.dist-info/licenses/LICENSE,sha256=TiDPM5WcFRQPoC5e46jGMeMppZ-eu0eFx_HytjE49bk,1105
-abstractvoice-0.3.0.dist-info/METADATA,sha256=_XLernZJC91kjzhBMIecBMN4bWcd2AerbPZ8rOmwFIc,38420
-abstractvoice-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-abstractvoice-0.3.0.dist-info/entry_points.txt,sha256=3bDX2dNOGvrsTx1wZ_o_hVgmM_a2zbcHc1ZkL154rN4,72
-abstractvoice-0.3.0.dist-info/top_level.txt,sha256=a1qyxqgF1O8cJtPKpcJuImGZ_uXqPNghbLZ9gp-UiOo,14
-abstractvoice-0.3.0.dist-info/RECORD,,