Update README.md

README.md

@@ -8,6 +8,83 @@ 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
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+*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! 🚀