Metadata-Version: 2.4
Name: voicestudio
Version: 1.0.1
Summary: VoiceStudio: A unified toolkit for text-style prompted speech synthesis, voice adaptation, and editing
Project-URL: Homepage, https://latentforge.github.io/
Project-URL: Repository, https://github.com/LatentForge/VoiceStudio
Author-email: LatentForge <brew.airesearch@gmail.com>
License: MIT
License-File: LICENSE
Keywords: audio-generation,hypernetworks,lora,text-to-speech,voice-synthesis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Requires-Dist: audioread>=3.0.0
Requires-Dist: av>=14.0.0
Requires-Dist: descript-audio-codec
Requires-Dist: descript-audiotools
Requires-Dist: einops>=0.8.1
Requires-Dist: einx>=0.3.0
Requires-Dist: hf-xet>=1.1.8
Requires-Dist: huggingface-hub
Requires-Dist: librosa>=0.10.2
Requires-Dist: librosa>=0.11.0
Requires-Dist: numba>=0.57.0
Requires-Dist: numpy>=2.3.5
Requires-Dist: packaging>=24.2
Requires-Dist: pandas
Requires-Dist: pillow>=11.0.0
Requires-Dist: pydub
Requires-Dist: safetensors>=0.5.2
Requires-Dist: sentencepiece
Requires-Dist: soundfile>=0.13.0
Requires-Dist: sox
Requires-Dist: soxr>=0.5.0.post1
Requires-Dist: torch; platform_system == 'Windows'
Requires-Dist: torch>=2.8.0
Requires-Dist: torchaudio; platform_system == 'Windows'
Requires-Dist: torchaudio>=2.8.0
Requires-Dist: torchcodec>=0.9.1
Requires-Dist: tqdm>=4.67.1
Requires-Dist: transformers==4.57.6
Requires-Dist: vector-quantize-pytorch
Requires-Dist: vocos
Provides-Extra: all
Requires-Dist: accelerate>=1.10.0; extra == 'all'
Requires-Dist: fastapi>=0.126.0; extra == 'all'
Requires-Dist: flash-attn; extra == 'all'
Requires-Dist: ipywidgets>=8.1.7; extra == 'all'
Requires-Dist: jiwer>=4.0.0; extra == 'all'
Requires-Dist: matplotlib>=3.10.5; extra == 'all'
Requires-Dist: notebook>=7.4.5; extra == 'all'
Requires-Dist: onnx; extra == 'all'
Requires-Dist: onnxruntime-gpu[cuda,cudnn]>=1.18.0; (platform_system == 'Linux' or platform_system == 'Windows') and extra == 'all'
Requires-Dist: onnxruntime>=1.18.0; (platform_system == 'Darwin') and extra == 'all'
Requires-Dist: pysptk>=1.0.1; extra == 'all'
Requires-Dist: pyworld>=0.3.5; extra == 'all'
Requires-Dist: speechbrain; extra == 'all'
Requires-Dist: utmosv2; extra == 'all'
Requires-Dist: wandb>=0.21.1; extra == 'all'
Provides-Extra: eval
Requires-Dist: jiwer>=4.0.0; extra == 'eval'
Requires-Dist: pysptk>=1.0.1; extra == 'eval'
Requires-Dist: pyworld>=0.3.5; extra == 'eval'
Requires-Dist: speechbrain; extra == 'eval'
Requires-Dist: utmosv2; extra == 'eval'
Provides-Extra: flash
Requires-Dist: flash-attn; extra == 'flash'
Provides-Extra: flash-prebuilt
Requires-Dist: flash-attn; extra == 'flash-prebuilt'
Provides-Extra: onnx
Requires-Dist: onnx; extra == 'onnx'
Requires-Dist: onnxruntime-gpu[cuda,cudnn]>=1.18.0; (platform_system == 'Linux' or platform_system == 'Windows') and extra == 'onnx'
Requires-Dist: onnxruntime>=1.18.0; (platform_system == 'Darwin') and extra == 'onnx'
Provides-Extra: train
Requires-Dist: accelerate>=1.10.0; extra == 'train'
Requires-Dist: ipywidgets>=8.1.7; extra == 'train'
Requires-Dist: matplotlib>=3.10.5; extra == 'train'
Requires-Dist: notebook>=7.4.5; extra == 'train'
Requires-Dist: wandb>=0.21.1; extra == 'train'
Provides-Extra: web
Requires-Dist: fastapi>=0.126.0; extra == 'web'
Description-Content-Type: text/markdown

# VoiceStudio

[![Python](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://www.python.org/)
[![PyTorch](https://img.shields.io/badge/PyTorch-2.0%2B-red.svg)](https://pytorch.org/)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

Your Complete Voice Adaptation Research Workspace

---

## 🎯 Overview

VoiceStudio is a unified toolkit for **text-style prompted speech synthesis**, enabling instant voice adaptation and editing through natural language descriptions. Built on cutting-edge research in voice style prompting, LoRA adaptation, and language-audio models.

**Key Features:**
- **Text-Conditional Generation**: Generate voice characteristics using natural language descriptions like "young female voice with warm tone"
- **Multimodal Input**: Support both text descriptions and audio feature vectors
- **Voice Editing**: Modify existing voices with simple instructions (Future Work)
- **Instant Adaptation**: Generate LoRA weights in a single forward pass without fine-tuning
- **Architecture Agnostic**: Works with multiple TTS architectures
- **Zero-shot Generalization**: Adapt to unseen voice characteristics not present in training data
- **Parameter Efficiency**: Minimal computational overhead compared to full model fine-tuning

---

## 🛠️ Installation

### From PyPI (Recommended)
```bash
uv add voicestudio[all]  # Install with all available base TTS models
```

### From Source
```bash
git clone https://github.com/LatentForge/voicestudio.git
cd voicestudio
uv pip install -e ".[all]"
```

### Development Installation
```bash
git clone https://github.com/LatentForge/voicestudio.git
cd voicestudio
uv pip install -e ".[all,web]"
```

### Building and Publishing
```bash
# Build package
uv build

# Upload to PyPI
uv publish
```

---

## 📊 Supported Models

VoiceStudio works with various TTS architectures:

| Model       | Status | Notes                 |
|-------------|--------|-----------------------|
| Parler-TTS  | ✅ Supported | Required further testing |
| Higgs-Audio | ✅ Supported | Required further testing |
| Qwen3-TTS   | ✅ Supported | Required further testing |
| Chroma      | ✅ Supported | Required further testing |
| Spark       | 🔄 Experimental | Coming soon           |
| Dia         | ✅ Supported | Fully tested (by HF)  |
| CozyVoice   | 🔄 Experimental | Coming soon           |
| F5-TTS      | 🔄 Experimental | Coming soon           |

**Add your own model**: See our [Integration Guide](docs/integration.md)

---

## 🤝 Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

**Areas we need help with:**
- 🔧 Additional TTS model adapters
- 📚 Documentation improvements
- 🐛 Bug fixes and testing
- 🌍 Multi-language support
- 🎨 New voice editing techniques

---

## 📝 License

This project is licensed under the MIT License - see [LICENSE](LICENSE) file for details.

The base TTS models supported by this project are subject to their own respective licenses. Users are responsible for reviewing and complying with each model’s license before use.

---

## 🙏 Acknowledgments

- **Sakana AI** for the original Text-to-LoRA concept
- **HyperTTS** authors for hypernetwork applications in TTS
- **The open-source community** for tools and datasets
- **CLAP**: Microsoft & LAION-AI for CLAP model
- **LoRA**: Microsoft for LoRA technique
- **HuggingFace**: For transformers library and model hub


## 📚 Citation

If you use VoiceStudio in your research, please cite:

```bibtex
@software{voicestudio2026,
  title={VoiceStudio: A Unified Toolkit for Voice Style Adaptation},
  author={Your Name},
  year={2026},
  url={https://github.com/LatentForge/voicestudio}
}
```
```bibtex
@article{t2a-lora-2025,
  title={T2A-LoRA: Text-to-Audio LoRA Generation via Hypernetworks for Real-time Voice Adaptation},
  author={LatentForge},
  journal={arXiv preprint arXiv:2501.XXXXX},
  year={2025}
}
```

## 🔗 Links

- **Paper**: [arXiv:2501.XXXXX](https://arxiv.org/abs/2501.XXXXX)
- **Demo**: [https://latentforge.github.io/VoiceStudio](https://latentforge.github.io/VoiceStudio)
- **Documentation**: [https://latentforge.github.io/VoiceStudio](https://latentforge.github.io/VoiceStudio)
- **Models**: [HuggingFace Hub](https://huggingface.co/LatentForge)

---

## 📞 Contact

- **Issues**: [GitHub Issues](https://github.com/LatentForge/VoiceStudio/issues)
- **Discussions**: [GitHub Discussions](https://github.com/LatentForge/VoiceStudio/discussions)
- **Email**: contact@latentforge.org

---

<p align="center">
  <img src="https://img.shields.io/github/stars/LatentForge/VoiceStudio?style=social" alt="Stars">
  <img src="https://img.shields.io/github/forks/LatentForge/VoiceStudio?style=social" alt="Forks">
  <img src="https://img.shields.io/github/watchers/LatentForge/VoiceStudio?style=social" alt="Watchers">
</p>

<p align="center">
  <strong>Made with ❤️ by LatentForge Team</strong>
</p>
