Update README.md

README.md

@@ -1,21 +1,29 @@
----
-license: mit
----
 # 🎵 GhostAI Music Generator 🎸
 
-The **GhostAI Music Generator** is an innovative web-based tool that leverages Meta AI's `musicgen-medium` model to create high-quality instrumental music tracks. With support for genres like Rock, Techno, Jazz, Classical, and Hip-Hop, this tool allows you to generate music with structured sections such as intros, verses, and choruses. It features a user-friendly Gradio interface, MP3 output, and advanced audio processing to ensure your tracks sound professional and polished.
+Welcome to the GhostAI Music Generator! This web-based tool utilizes Meta AI's `musicgen-medium` model to craft high-quality instrumental tracks across genres such as Rock, Techno, Jazz, Classical, and Hip-Hop. The application structures compositions with sections like intros, verses, and choruses, all accessible through an intuitive Gradio interface. Outputs are high-quality MP3 files at 320 kbps, complete with embedded metadata. To enhance audio quality, we've integrated processing features including equalization (EQ), a chorus effect, and peak limiting for a polished sound.
 
-This project began as a simple music generation tool but quickly evolved to tackle challenges like VRAM limitations, audio quality, and song structure. Through a series of updates, we optimized memory usage by splitting tracks into chunks, enhanced song flow with varied prompts for each section, and refined the audio with EQ, a chorus effect, and peak limiting. The result is a powerful music creation platform that’s both accessible and customizable.
+## Project Evolution and Optimization
 
-## Features
-- **AI-Powered Music Generation**: Generate instrumental tracks in multiple genres using the `musicgen-medium` model.
-- **Structured Song Sections**: Create tracks with distinct intros, verses, and choruses by using varied prompts for each chunk.
-- **Gradio Web Interface**: Easily input prompts, adjust generation settings, and preview your music through an intuitive UI.
-- **MP3 Output**: Save your tracks as high-quality MP3 files (320 kbps) with embedded metadata.
-- **Audio Processing**: Enhance your music with EQ, a chorus effect for richness, and limiting to control peaks while preserving dynamics.
+Initially, the project faced VRAM limitations on an NVIDIA RTX 3060 Ti with 7.69 GiB. To address this, we divided 30-second tracks into manageable chunks—first into three 10-second segments, then into two 15-second segments—to optimize memory usage. The Bark model was removed to focus solely on instrumental generation, and we standardized the output format to MP3 for broader compatibility. To achieve a more natural song flow, we varied prompts for each chunk. For instance, the first chunk might use "dynamic intro and expressive verse," while the second employs "powerful chorus and energetic outro," providing a realistic song structure.
 
-## Installation
-To get started with the GhostAI Music Generator, follow these steps:
+Audio enhancements include:
+- **EQ**: Low-pass filter at 6000 Hz and high-pass filter at 100 Hz.
+- **Chorus Effect**: 20ms delay with a -4 dB gain.
+- **Peak Limiting**: Strict limiting at -8.0 dB to control peaks.
+- **Gain Adjustment**: +2 dB boost before crossfading to address amplitude dips.
+- **Compression**: Removed to preserve dynamic range.
+
+## System Requirements
+
+To get started, ensure your system meets the following requirements:
+- **Operating System**: Ubuntu (Note: Windows/macOS are untested).
+- **GPU**: CUDA-capable GPU with at least 8 GB VRAM.
+- **Python**: Version 3.10.
+- **ffmpeg**: Installed for audio processing.
+
+## Installation and Setup
 
 1. **Clone the Repository**:
-   Clone the project from Hugging Face and navigate to the directory:
+   ```bash
+   git clone https://huggingface.co/your-username/ghostai-music-generator
+   cd ghostai-music-generator