Update README.md

README.md

@@ -10,5 +10,85 @@ pinned: false
 license: apache-2.0
 short_description: alot of local zero build
 ---
+GhostAI Music Generator
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+License: MIT
+Python: 3.10
+CUDA: 11.8 | 12.1
+
+The GhostAI Music Generator is a web-based application powered by Meta AI's musicgen-medium model, hosted as a demo in a Hugging Face Space. It creates high-quality instrumental tracks across genres, including Rock, Techno, Jazz, Classical, and Hip-Hop. The tool generates structured compositions with sections such as intros, verses, and choruses, accessible via an intuitive Gradio interface. Outputs are 320 kbps MP3 files with embedded metadata, enhanced by audio processing features like equalization (EQ), chorus effects, and peak limiting for professional-grade sound.
+
+- License: MIT
+- Tags: Python, AI, Music Generation
+
+Features
+
+- Genre Versatility: Supports Rock, Techno, Jazz, Classical, and Hip-Hop with customizable prompts.
+- Structured Compositions: Generates tracks with dynamic intros, verses, choruses, and outros.
+- Audio Enhancements:
+  - Equalization: Low-pass filter at 6000 Hz, high-pass at 100 Hz.
+  - Chorus Effect: 20ms delay with -4 dB gain.
+  - Peak Limiting: Set at -8.0 dB to control peaks.
+  - Gain Adjustment: +2 dB boost before crossfading.
+  - Compression: Removed to preserve dynamic range.
+- Output: High-quality 320 kbps MP3 files with metadata.
+- Interface: Gradio UI for easy interaction in the Hugging Face Space.
+
+Project Evolution
+
+The project was optimized for a GPU with 7.69 GiB VRAM by splitting 30-second tracks into two 15-second chunks, reducing memory usage. The Bark model was removed to focus on instrumental generation, and MP3 was standardized for compatibility. Varied prompts (e.g., "dynamic intro and expressive verse" for the first chunk, "powerful chorus and energetic outro" for the second) ensure natural song flow.
+
+Using the Interface
+
+In the Hugging Face Space Gradio interface:
+- Select a Genre: Choose from Rock, Techno, Jazz, Classical, or Hip-Hop.
+- Custom Prompt: Enter a description, e.g.:
+  Hard rock with a dynamic intro, expressive verse, and powerful chorus, featuring electric guitars, steady heavy drums, and deep bass.
+- Adjust Parameters:
+  - Guidance Scale (CFG): Default is 3.0.
+  - Top-K Sampling: Default is 300.
+  - Top-P Sampling: Default is 0.95.
+  - Temperature: Default is 1.0.
+  - Total Duration: Set to 30 seconds (range: 10-60).
+  - Crossfade Duration: Set to 500 ms (range: 100-2000).
+- Generate Music: Click "Generate Music" to create the track. The output is saved as output_cleaned.mp3 and playable in the interface.
+
+Troubleshooting and Customization
+
+- Quiet Spots in Waveform: Increase gain before crossfading by modifying app.py:
+  python
+  next_segment = next_segment + 3
+  Use audio tools like Audacity to inspect the waveform.
+
+- Enhancing the Chorus: Modify the second chunk prompt in the interface to:
+  explosive chorus with soaring guitars and pounding drums
+  Or increase temperature to 1.2 and top_k to 350.
+
+- Audio Distortion: Reduce chorus effect gain in app.py:
+  python
+  delayed = segment - 6
+  Adjust EQ settings in apply_eq with high-pass at 80 Hz and low-pass at 5000 Hz.
+
+- Use a Smaller Model: For lower resource use, switch to musicgen-small in app.py:
+  python
+  musicgen_model = MusicGen.get_pretrained('facebook/musicgen-small', device=device)
+
+- Add New Genres: Define a new genre prompt in app.py:
+  python
+  def set_pop_prompt():
+      return "Pop with a catchy intro, upbeat verse, and anthemic chorus, featuring bright synths, punchy drums, and groovy bass"
+  Add a button:
+  python
+  pop_btn = gr.Button("Pop", elem_classes="genre-btn")
+  pop_btn.click(set_pop_prompt, inputs=None, outputs=[instrumental_prompt])
+
+Acknowledgments
+
+Special thanks to:
+- Meta AI for musicgen-medium and Audiocraft.
+- Hugging Face for hosting and CLI tools.
+- Gradio for the web interface.
+- pydub for audio processing and MP3 export.
+- xAI for their support.
+
+Enjoy creating music! For questions or suggestions, open an issue in the repository.