Update README.md

README.md

@@ -40,11 +40,11 @@ license: cc-by-nc-sa-4.0
 
 # MALIBA-AI Bambara TTS: Revolutionary Speech Synthesis for Bambara Language 🇲🇱
 
-MALIBA-AI Bambara TTS represents a groundbreaking advancement in African language technology, offering the **first open-source, high-quality text-to-speech synthesis** specifically designed for the Bambara language. Built on cutting-edge Spark-TTS architecture, this model brings professional-grade voice synthesis to a language spoken by over 14 million people across West Africa.
+MALIBA-AI Bambara TTS represents a groundbreaking advancement in African language technology, offering **open-source, high-quality text-to-speech synthesis** specifically designed for the Bambara language. Built on cutting-edge Spark-TTS architecture, this model brings professional-grade voice synthesis to a language spoken by over 14 million people across West Africa.
 
 ## Bridging the Digital Language Divide
 
-Bambara (Bamanankan) is the most widely spoken language in Mali and serves as a lingua franca across West Africa. Despite its significance, Bambara has been severely underrepresented in speech technology. MALIBA-AI Bambara TTS directly addresses this critical gap, making digital speech interfaces accessible to Bambara speakers for the first time and advancing digital inclusion across the region.
+Bambara (Bamanankan) is the most widely spoken language in Mali and serves as a lingua franca across West Africa. Despite its significance, Bambara has been severely underrepresented in speech technology. MALIBA-AI Bambara TTS directly addresses this critical gap, making digital speech interfaces accessible to Bambara speakers for the first time open-source and advancing digital inclusion across the region.
 
 ## Table of Contents
 - [Technical Specifications](#technical-specifications)
@@ -84,50 +84,19 @@ Bambara (Bamanankan) is the most widely spoken language in Mali and serves as a
 MALIBA-AI Bambara TTS features **10 distinct authentic Bambara speakers**, each with unique characteristics:
 
 ### Available Speakers
-- **Adama**: Natural conversational tone, ideal for dialogues
-- **Moussa**: Clear pronunciation, excellent for educational content
-- **Bourama**: Most stable and accurate (recommended for production)
-- **Modibo**: Expressive delivery, great for storytelling
-- **Seydou**: Balanced characteristics, versatile for various applications
-- **Amadou**: Warm and friendly voice, suitable for customer service
-- **Bakary**: Deep, authoritative tone, perfect for announcements
-- **Ngolo**: Youthful and energetic, ideal for youth-oriented content
-- **Ibrahima**: Calm and measured, excellent for meditation or relaxation content
-- **Amara**: Melodic and smooth, perfect for poetry and artistic content
-
-### Speaker Quality
-- **High Fidelity**: All speakers trained on high-quality Bambara speech data
-- **Regional Representation**: Voices represent different Bambara-speaking regions
-- **Cultural Authenticity**: Native speaker recordings ensure authentic pronunciation
-- **Consistent Quality**: Standardized training process across all speakers
-
-## Transforming Access to Technology
-
-MALIBA-AI Bambara TTS enables numerous applications previously unavailable to Bambara speakers:
-
-### Educational Applications
-- **Language Learning**: Pronunciation guides and interactive lessons
-- **Literacy Programs**: Audio support for reading and writing instruction
-- **Digital Textbooks**: Voice narration of educational content
-- **Assessment Tools**: Audio-based testing and evaluation
-
-### Accessibility & Inclusion
-- **Screen Readers**: Making digital content accessible to visually impaired users
-- **Communication Aids**: Assistive technology for speech impairments
-- **Mobile Accessibility**: Voice interfaces for users with limited literacy
-- **Elderly Support**: Audio interfaces for older adults less familiar with text
-
-### Cultural & Community Applications
-- **Oral Tradition Preservation**: Digital narration of stories and cultural heritage
-- **Religious Content**: Audio versions of religious texts and prayers
-- **Local Media**: Voice-over for radio, podcasts, and digital content
-- **Public Services**: Automated announcements and information systems
-
-### Technology Integration
-- **Voice Assistants**: Bambara-speaking AI assistants and chatbots
-- **Mobile Apps**: Voice responses and audio feedback in native language
-- **Smart Devices**: IoT devices with Bambara voice interfaces
-- **Gaming**: Character voices and narration in Bambara
+- **Adama**
+- **Moussa**
+- **Bourama**
+- **Modibo**
+- **Seydou**
+- **Amadou**
+- **Bakary**
+- **Ngolo**
+- **Ibrahima**
+- **Amara**
+
+**Note**: try them and choose your preference for your use case.
+
 
 ## Installation
 
@@ -162,7 +131,7 @@ import soundfile as sf
 tts = BambaraTTSInference()
 
 # Generate speech from Bambara text
-text = "Aw ni ce. I ka kɛnɛ wa?"  # "Hello. How are you?"
+text = "Aw ni ce. I ka kɛnɛ wa?"  
 audio = tts.generate_speech(text, speaker_id=Speakers.Bourama)
 
 # Save the audio
@@ -188,16 +157,33 @@ audio = tts.generate_speech(
 ### Multi-Speaker Examples
 
 ```python
-# Educational content with different speakers
-lessons = [
-    ("Walanda fɔlɔ: I ni ce", Speakers.Adama),      # "Lesson one: Hello"
-    ("Walanda filanan: Tɔgɔ", Speakers.Moussa),     # "Lesson two: Names"
-    ("Walanda sabanan: Jamu", Speakers.Bourama),    # "Lesson three: Family"
-]
-
-for lesson, speaker in lessons:
-    audio = tts.generate_speech(lesson, speaker_id=speaker)
-    print(f"Generated lesson with speaker {speaker.id}")
+from maliba_ai.config.settings import Speakers
+
+text = "Aw ni ce. Ne tɔgɔ ye Adama. Awɔ,  ne ye maliden de ye. Aw Sanbɛ Sanbɛ. San min tɛ ɲinan ye, an bɛɛ ka jɛ ka o seli ɲɔgɔn fɛ,  hɛɛrɛ  ni lafiya la. Ala ka Mali suma. Ala ka Mali yiriwa. Ala ka Mali taa ɲɛ. Ala ka an ka seliw caya. Ala ka yafa an bɛɛ ma."
+
+#let's try Adama
+tts.generate_speech(
+    text = text, 
+    speaker_id = Speakers.Adama,
+    output_filename = "adama.wav"
+)
+
+
+#let's try Seydou
+tts.generate_speech(
+    text = text, 
+    speaker_id = Speakers.Seydou,
+    output_filename = "seydou.wav"
+)
+
+
+# let's try Bourama
+tts.generate_speech(
+    text = text, 
+    speaker_id = Speakers.Bourama,
+    output_filename = "bourama.wav"
+)
+
 ```
 
 ## Performance & Quality
@@ -208,19 +194,8 @@ for lesson, speaker in lessons:
 - **Intelligibility**: 95%+ word recognition accuracy
 - **Pronunciation Accuracy**: Native-level Bambara pronunciation
 
-### Performance Characteristics
-- **Real-time Factor**: 0.3x (generates 1 second of audio in 0.3 seconds on GPU)
-- **Memory Usage**: ~4GB RAM recommended, 2GB minimum
-- **GPU Acceleration**: 10x faster generation with CUDA
-- **Inference Speed**: ~2-5 seconds for typical sentences
-- **Audio Quality**: Professional broadcast quality (16kHz, 16-bit)
 
-### Supported Hardware
-- **GPU**: NVIDIA GPUs with CUDA support (recommended)
-- **CPU**: Intel/AMD processors (functional but slower)
-- **Memory**: 4GB+ RAM recommended
-- **Storage**: ~2GB for model files
-- **OS**: Linux, Windows, macOS
+
 
 ## Limitations
 
@@ -229,43 +204,13 @@ for lesson, speaker in lessons:
 #### Language Mixing (Code-Switching)
 - **French-Bambara Mixing**: The model performs poorly when French words or phrases are mixed within Bambara text
 - **Recommendation**: Use pure Bambara text for optimal results
-- **Workaround**: Separate French and Bambara content into different synthesis calls
-
-```python
-# ❌ Poor results - mixed languages
-mixed_text = "I ni ce, comment allez-vous?"
 
-# ✅ Better approach - separate languages
-bambara_text = "I ni ce"  # "Hello"
-# Use separate French TTS for French parts
-```
 
 #### Numeric Content
 - **Digital Numbers**: Poor performance with Arabic numerals (1, 2, 3, etc.)
 - **Written Numbers**: Good performance with Bambara number words
 - **Recommendation**: Convert digits to written Bambara number words
 
-```python
-# ❌ Poor results - digital numbers
-poor_text = "N ye bagan 25 san"  # "I bought 25 bags"
-
-# ✅ Better results - written numbers  
-good_text = "N ye bagan mugan ni duuru ye san"  # "I bought twenty-five bags"
-```
-
-#### Other Limitations
-- **Punctuation Sensitivity**: Complex punctuation may affect prosody
-- **Very Long Texts**: Best results with sentences under 100 words
-- **Technical Terms**: Limited vocabulary for highly technical or modern terms
-- **Regional Dialects**: Optimized for standard Bambara; dialectal variations may vary in quality
-
-### Optimization Tips
-- Use standard Bambara orthography as defined by the Academy of African Languages
-- Write out numbers and dates in Bambara words
-- Keep sentences to reasonable lengths (10-50 words)
-- Use proper Bambara punctuation conventions
-- Test different speakers for your specific content type
-
 ## The MALIBA-AI Impact
 
 MALIBA-AI Bambara TTS is part of MALIBA-AI's broader mission: **"No Malian Left Behind by Technological Advances."** This initiative is actively transforming Mali's digital landscape by:
@@ -273,8 +218,7 @@ MALIBA-AI Bambara TTS is part of MALIBA-AI's broader mission: **"No Malian Left
 ### Digital Inclusion
 1. **Breaking Language Barriers**: Providing technology in languages that Malians actually speak
 2. **Literacy Support**: Audio interfaces for users with varying literacy levels
-3. **Rural Access**: Voice technology for areas with limited internet and education infrastructure
-4. **Cultural Preservation**: Digitizing and preserving Mali's rich oral traditions in Bambara
+3. **Cultural Preservation**: Digitizing and preserving Mali's rich oral traditions 
 
 ### Technological Empowerment
 1. **Local Innovation**: Enabling Malian developers to build voice-based applications
@@ -299,23 +243,14 @@ MALIBA-AI is committed to continuous improvement with planned developments:
 - **Voice Cloning**: Zero-shot voice cloning capabilities for new speakers
 - **Streaming Audio**: Real-time streaming synthesis for interactive applications
 
-### Language Expansion
-- **Additional Malian Languages**: Integration with MALIBA-AI's multi-language TTS
-- **Dialect Support**: Specialized models for regional Bambara variants
-- **Cross-Lingual Features**: Better support for multilingual content
 
-### Community Integration
-- **Speaker Expansion**: Additional authentic Bambara speakers
-- **Quality Improvements**: Continuous model refinement based on community feedback
-- **Application Development**: Reference implementations for common use cases
-- **Training Resources**: Educational materials for developers and researchers
 
 ## References
 
 ```bibtex
 @software{maliba_ai_bambara_tts_2025,
-  title={MALIBA-AI Bambara Text-to-Speech: First Open-Source TTS for Bambara Language},
-  author={MALIBA-AI Team},
+  title={MALIBA-AI Bambara Text-to-Speech: Open-Source Hight Quality TTS for Bambara Language},
+  author={Seydou DIALLO},
   year={2025},
   publisher={HuggingFace},
   url={https://huggingface.co/MALIBA-AI/bambara-tts},
@@ -332,13 +267,6 @@ MALIBA-AI is committed to continuous improvement with planned developments:
   url={https://arxiv.org/abs/2503.01710}
 }
 
-@article{bamana_language_2024,
-  title={Bambara Language and Digital Inclusion in Mali},
-  author={MALIBA-AI Research Team},
-  journal={African Language Technology Review},
-  year={2024},
-  note={In preparation}
-}
 ```
 
 ## License
@@ -353,7 +281,7 @@ This project is licensed under **Creative Commons Attribution-NonCommercial-Shar
 - **Attribution Required**: Must credit MALIBA-AI and Spark-TTS
 
 ### Commercial Usage
-For commercial licensing options, contact: contact@maliba-ai.com
+For commercial licensing options, contact: ml.maliba.ai@gmail.com
 
 ### Attribution Requirements
 ```
@@ -377,7 +305,7 @@ MALIBA-AI Bambara TTS is part of the broader MALIBA-AI initiative with the missi
 ### How to Contribute
 - **GitHub**: [MALIBA-AI/bambara-tts](https://github.com/MALIBA-AI/bambara-tts)
 - **HuggingFace**: [MALIBA-AI](https://huggingface.co/MALIBA-AI)
-- **Email**: contact@maliba-ai.com
+- **Email**: ml.maliba.ai@gmail.com
 - **Community**: Join discussions on model improvements and applications
 
 ### Contribution Guidelines
@@ -390,13 +318,11 @@ MALIBA-AI Bambara TTS is part of the broader MALIBA-AI initiative with the missi
 
 **MALIBA-AI: Empowering Mali's Future Through Community-Driven AI Innovation**
 
-*"MALIBA-AI ka baara kɛ ka bamanankan lakana diɲɛ kɔnɔ!"*
-*(MALIBA-AI works to preserve Bambara language in the world!)*
-
+*"No Malian Language Left Behind"*
 ---
 
 **Contact Information:**
-- Website: [maliba-ai.com](https://maliba-ai.com)
-- Email: contact@maliba-ai.com
+- Website: [maliba-ai.org](https://maliba-ai.org)
+- Email: ml.maliba.ai@gmail.com
 - GitHub: [MALIBA-AI](https://github.com/MALIBA-AI)
 - HuggingFace: [MALIBA-AI](https://huggingface.co/MALIBA-AI)