Text-To-Voice / README.md
MrHalk's picture
Update README.md
bdec5f6 verified
|
raw
history blame
3.09 kB
---
title: Text To Voice
emoji: 🐨
colorFrom: blue
colorTo: yellow
sdk: streamlit
sdk_version: 1.42.0
app_file: app.py
pinned: false
short_description: Text based command and voice based output.
thumbnail: >-
https://cdn-uploads.huggingface.co/production/uploads/662ba6f848b0b3742e6f9261/g5AwtsLlMV-uouzWRznGj.png
---
# 🎀 AI-Powered Voice Generator
*A smart and efficient Text-to-Speech application with voice modification and enhancement.*
## πŸš€ About the Project
This **AI-Powered Voice Generator** is a Python-based application that converts text into speech with natural, clear voices. The app allows users to generate and modify voices using **offline** (pyttsx3) and **online** (Google TTS) engines. Additionally, users can change the voice pitch (male/female) and download the generated audio.
## ✨ Features
βœ… Convert text into speech using **pyttsx3** (offline) or **Google TTS** (online).
βœ… Modify voice pitch (Male/Female).
βœ… Normalize and enhance audio for clarity.
βœ… Download generated voice files.
βœ… Simple and interactive **Streamlit** user interface.
βœ… No need for external API keys (offline mode).
## πŸ“Έ Screenshot
### 🎀 Main Interface
![Main UI](https://github.com/Arman1263/Text-To-Voice/blob/f3afd87307015cd1b77d0bd71c0d96b9f1fffa65/img.png)
### πŸŽ™οΈ Voice Output
![Voice Options](https://github.com/Arman1263/Text-To-Voice/blob/05e3782cfe42ea134c4051da492176d774e2c154/img1.png)
## πŸ› οΈ Installation
Follow these steps to set up and run the project locally.
### 1️⃣ Clone the Repository
```bash
git clone https://github.com/your-username/voice-generator.git
cd voice-generator
```
### 2️⃣ Create a Virtual Environment (Optional but Recommended)
```bash
python -m venv venv
source venv/bin/activate # On Mac/Linux
venv\Scripts\activate # On Windows
```
### 3️⃣ Install Dependencies
```bash
pip install -r requirements.txt
```
### 4️⃣ Run the Application
```bash
streamlit run app.py
```
## 🎯 Usage
1. Open the **Voice Generator App** in your browser.
2. Enter your text in the text box.
3. Choose the **engine** (Offline/Online) and **voice type** (Male/Female).
4. Click **Generate Voice** to convert the text to speech.
5. Listen to the generated audio and **download** it if needed.
## πŸ“ Technologies Used
- **Python** 🐍
- **Streamlit** 🎨 (For interactive UI)
- **pyttsx3** πŸ”Š (Offline Text-to-Speech)
- **gTTS** 🌍 (Google TTS for Online Mode)
- **pydub** 🎡 (Audio Processing)
- **librosa** 🎢 (Voice Modifications)
- **NumPy & SoundFile** πŸ”‰ (Signal Processing)
## 🀝 Contributing
Contributions are welcome! If you’d like to improve the project:
1. Fork the repository 🍴
2. Create a new branch: `git checkout -b feature-name`
3. Make your changes and commit them.
4. Push to your branch: `git push origin feature-name`
5. Open a Pull Request πŸš€
## πŸ“¬ Contact
πŸ’‘ **Author:** Arman Amir Shikalgar
πŸ“§ **Email:** [email protected]
🌍 **GitHub:** [My GitHub](https://github.com/Arman1263)
πŸ“’ Feel free to connect and contribute! πŸš€