Commit graph

7 commits

Author SHA1 Message Date
Claude
848c2c6cb5 Integrate Silero TTS and add infrastructure for Chatterbox/Kokoro
INTEGRATED: Silero TTS (tts-1-silero)
- Added silero_wrapper class to speech.py for PyTorch Hub integration
- CPU-friendly, no GPU required (48kHz sample rate)
- Supports 5 languages: English (117 speakers), Russian, German, Spanish, French
- Loads on-demand via torch.hub from snakers4/silero-models
- Added 6 OpenAI-compatible voice mappings (alloy, echo, fable, etc.)

PREPARED: Chatterbox & Kokoro TTS
- Added dependencies to requirements.txt:
  * git+https://github.com/resemble-ai/chatterbox.git
  * transformers>=4.35.0 (for Kokoro)
  * huggingface-hub[cli] (for model downloads)
- Created Makefile targets for downloading models
- Created test targets for all three new engines

Makefile Enhancements:
- make voices-silero: Download Silero models (en, ru, de, es, fr)
- make test-silero: Test Silero TTS endpoint
- make voices-chatterbox: Download Chatterbox models via HF CLI
- make test-chatterbox: Test Chatterbox with emotion control
- make voices-kokoro: Download Kokoro models via HF CLI
- make test-kokoro: Test Kokoro fast synthesis

speech.py Changes:
- Added silero_wrapper class with tts() method
- Added tts-1-silero model handler in generate_speech()
- Registered tts-1-silero model in app
- Added PCM media type for Silero (48000 Hz)
- Global state: silero_model, silero_speakers dict

Configuration:
- Updated voice_to_speaker.default.yaml with tts-1-silero section
- Mapped all 6 OpenAI voices to Silero speakers (en_0 through en_5)

Documentation:
- Updated docs/MODELS.md: Silero marked as  INTEGRATED
- Updated roadmap: Phase 1 task 3 completed
- Updated status footer: 3 models rescued
- Added integration examples and Makefile commands

Next Steps:
- Test Silero integration in Docker
- Implement Chatterbox emotion control engine
- Implement Kokoro fast decoder engine
2025-11-09 10:48:44 -05:00
Claude
2d1e1b344f Add comprehensive TTS model documentation and research
Added detailed documentation for 10 TTS models:
- Coqui TTS (XTTS-v2): High-quality multilingual with voice cloning
- Mozilla TTS: Historical context, superseded by Coqui
- Piper TTS: Fast, lightweight, 100+ voices
- Chatterbox: Emotion control, 23 languages
- Mimic 3: Privacy-focused, offline capable
- eSpeak NG: 100+ languages, accessibility-focused
- Kokoro TTS: Fast decoder-only architecture
- Tortoise TTS: Studio-quality but slow
- Step-Audio-EditX: Experimental LLM-based audio editing
- Maya1: Indic languages specialist

Created comprehensive research overview:
- Complete model comparison matrix
- Performance characteristics and feature analysis
- License compatibility analysis
- Integration roadmap and priorities
- Raccoon Mission risk assessment

Updated MODELS.md:
- Added documentation index with links to all model docs
- Added research overview reference
- Added detailed doc references in existing sections
- Added "Additional Models Under Research" section

All documentation follows Raccoon Mission theme of rescuing
abandoned open-source TTS models for long-term preservation.
2025-11-09 10:48:32 -05:00
cd4248045e Update MODELS.md with comprehensive TTS engine documentation
- Expanded Piper TTS and Coqui XTTS sections with full details
- Added Mozilla TTS (historical reference, skip in favor of Coqui)
- Added Chatterbox (voice assistant framework)
- Added Mimic 3 (Mycroft TTS, at-risk from shutdown)
- Added eSpeak NG (legacy formant synthesis, 100+ languages)
- Added Kokoro TTS (new 2024 project, StyleTTS2-based)
- Expanded Silero TTS as HIGHEST priority (actively maintained)
- Documented licenses, repositories, model hubs for all engines
- Added integration effort estimates and raccoon priorities

This update provides comprehensive tracking of all TTS engines for
the raccoon mission to rescue and integrate abandoned models.

🦝 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 10:37:57 -05:00
2c6c1ad577 Add XTTS support to Makefile and create CLAUDE.md guide
Makefile improvements:
- Add voices-xtts target to download speaker samples
- Add test-xtts target for testing HD model
- Split voices into voices-piper and voices-xtts
- Update help text with all new targets

speech.py:
- Fix threading import scope issue for XTTS
- Remove redundant 'import threading' inside Piper block

docs/CLAUDE.md:
- Complete guide for Claude Code contributors
- Makefile-first development philosophy
- Never create dirs manually, always use Makefile
- Documentation requirements and testing philosophy
- Common mistakes to avoid
- Raccoon mission values and principles

This ensures consistent, repeatable deployments and makes it easy
to add new TTS engines following the same pattern.

🦝 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 09:52:13 -05:00
874a7f170c Add comprehensive repository audit and raccoon mission roadmap
Created docs/AUDIT.md with:
- Complete file inventory and assessment
- Analysis of 10+ abandoned TTS models to integrate
- Multi-tier binary mirror strategy
- Proposed refactoring with engine abstraction
- License clarification (AGPL v3, not MIT)

This audit identifies all non-essential files for removal and documents
the plan to rescue abandoned TTS projects (Silero, StyleTTS2, Bark, etc.)
into a unified resilient system.

🦝 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 09:32:22 -05:00
3a9e27e556 Add comprehensive TTS model and mirror documentation
docs/MODELS.md:
- Document 10+ abandoned TTS engines to integrate
- Piper TTS (integrated, fixed)
- Coqui XTTS v2 (integrated, company shut down)
- Silero TTS (HIGH PRIORITY - still active, fast)
- StyleTTS2 (HIGH PRIORITY - best quality)
- Fish Speech (active, good quality)
- Kokoro, Bark, Tortoise, MetaVoice (lower priority)
- Integration roadmap with time estimates
- Performance targets and storage requirements

docs/MIRRORS.md:
- Multi-tier mirror strategy for resilience
- Tier 1: Upstream (HuggingFace, PyPI, GitHub)
- Tier 2: Self-hosted MinIO on ai.foxhop.net
- Tier 3: Archive.org for public archival
- Tier 4: IPFS for decentralization
- Complete implementation with scripts and configs
- Fallback download logic
- Recovery scenarios
- Cost: $0-20/month

Raccoon mission: Ensure TTS keeps working when upstream dies.
Documentation-first approach before implementing features.

🦝 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 09:28:02 -05:00
e8183b4585 Organize repository: create scripts/ and docs/ directories
- Move utility scripts to scripts/ directory:
  - add_voice.py (add custom voices)
  - say.py (CLI TTS client)
  - test_voices.sh (voice testing)
  - download_samples.sh (OpenAI samples)

- Remove Windows batch files (.bat) - Linux/Docker focus
  - startup.bat
  - download_samples.bat
  - download_voices_tts-1.bat
  - download_voices_tts-1-hd.bat

- Create docs/ directory with AUDIT.md:
  - Complete repository file audit
  - Document 10+ abandoned TTS models to integrate
  - Plan for binary mirror strategy
  - Outline future refactoring to src/ structure

Raccoon mission: Scripts are in scripts/, docs reference them.
No code belongs in docs/ - only documentation.

🦝 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 09:25:21 -05:00