🎙️ Voice Forge by Murf AI

Transform voices with the power of AI - A modern web application for voice transformation and audio processing.

DEMO

https://drive.google.com/file/d/1P6YLn10oqySe5-tYWalDNrclb23KgblB/view?usp=sharing

🌟 Features

Voice Forge is your go-to platform for voice transformation, offering:

• 🎤 Real-time Voice Recording - Record audio directly in your browser
• 📁 Audio File Upload - Transform existing audio files
• 🔄 Voice Transformation Options:
  • Gender transformation (Male ↔️ Female)
  • Accent modifications
  • Tone and pitch adjustments
• 🎵 Real-time Preview - Listen to transformations instantly
• 📥 Easy Export - Download transformed audio in various formats
• 📊 Transformation History - Track and manage your voice transformations
• 🔒 Secure Processing - All data handling follows best security practices

🚀 Quick Start

Prerequisites

• Docker & Docker Compose
• Git
• A Murf API key (for voice transformation)

Local Development

1. Clone the repository

   git clone https://github.com/MohanMahesh10/Voice-Forge-Murf-AI.git
   cd Voice_Forge
   

2. Set up environment variables

   # Create .env file
   echo "MURF_API_KEY=your_api_key_here" > .env
   

3. Launch the application

   docker-compose up
   

4. Access the application

   • 🌐 Web Interface: http://localhost:5173
   • 🔧 API Endpoint: http://localhost:8000
   • 📚 API Docs: http://localhost:8000/docs

🏗️ Architecture

Voice Forge is built with a modern, scalable architecture:

Backend (FastAPI)

• Core: Python 3.9+ with FastAPI framework
• Audio Processing:
  • pydub for audio manipulation
  • NumPy for signal processing
  • Custom pitch-shifting algorithms
• Storage: Azure Blob Storage for audio files
• Security: Azure Key Vault for secrets management

Frontend (Svelte)

• Framework: SvelteKit for optimal performance
• Styling: TailwindCSS for responsive design
• Audio Visualization: WaveSurfer.js
• State Management: Built-in Svelte stores
• Notifications: Svelte French Toast

DevOps

• Containerization: Docker & Docker Compose
• CI/CD: GitHub Actions
• Cloud: Azure Container Apps
• Monitoring: Azure Application Insights

📡 API Endpoints

// Available endpoints
GET  /api/voices     // List available voice profiles
POST /api/transform  // Transform audio with selected profile
GET  /api/history    // Get transformation history

📂 Project Structure

Voice_Forge/
├── 🔧 backend/               # FastAPI service
│   ├── main.py              # Core application logic
│   ├── requirements.txt     # Python dependencies
│   └── Dockerfile          # Backend container config
├── 🎨 frontend/             # Svelte application
│   ├── src/                # Source code
│   │   ├── lib/           # Shared components
│   │   └── routes/        # Page components
│   └── Dockerfile         # Frontend container config
└── 🐳 docker-compose.yml    # Container orchestration

🚀 Deployment

Azure Deployment

Voice Forge is optimized for Azure deployment:

1. Automated Deployment

   # Using provided script
   ./deploy.sh
   

2. Manual Deployment

   • Follow Azure Deployment Guide
   • Uses Azure Container Apps for scalability
   • Integrates with Azure Key Vault for secrets

Custom Deployment

The application can be deployed to any platform supporting Docker:

1. Build the containers:

   docker-compose build
   

2. Configure environment variables

3. Launch the application:

   docker-compose up -d
   

🛠️ Development

Setting Up Development Environment

1. Backend Development

   cd backend
   python -m venv venv
   source venv/bin/activate  # or `venv\Scripts\activate` on Windows
   pip install -r requirements.txt
   uvicorn main:app --reload
   

2. Frontend Development

   cd frontend
   npm install
   npm run dev
   

Running Tests

# Backend tests
cd backend
pytest

# Frontend tests
cd frontend
npm run test

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

• FastAPI - For the powerful Python web framework
• Svelte - For the reactive frontend framework
• TailwindCSS - For the utility-first CSS framework
• WaveSurfer.js - For audio visualization
• Murf API - For voice transformation capabilities

@2025 MOHAN MAHESH