Update README.md

README.md

@@ -11,3 +11,46 @@ license: mit
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+title: Professional Loop Pack Automation Tool
+emoji: 🎧
+colorFrom: blue
+colorTo: purple
+sdk: gradio
+sdk_version: 4.38.1 # Recommended stable version for Gradio
+app_file: app.py
+pinned: false
+
+🚀 Professional Loop Pack Automation Tool
+
+Welcome to the Professional Loop Pack Automation Tool, built by a fellow music producer! This application automates the tedious process of creating sample packs for marketplaces like Gumroad, Beatstars, and Airbit.
+
+🌟 Features
+
+This tool takes a full musical track and performs the following professional-grade processing steps:
+
+Real Stem Separation (via Spleeter): Splits the audio into high-quality, discrete musical stems (Drums, Bass, Vocals, etc.) based on the model you select (2, 4, or 5 stems).
+
+Advanced Analysis: Automatically detects and labels the BPM and Musical Key of the source audio.
+
+Time-Aligned Looping: Cuts clean, grid-accurate loops in industry-standard lengths (4, 6, and 8 bars).
+
+Transient Detection & One-Shots: Extracts individual percussive or melodic one-shots with an adjustable sensitivity slider.
+
+Market-Ready Packaging: Organizes all files into a logical folder structure (LOOPS/, ONESHOTS/), labels them with BPM and Key, includes a Royalty-Free License.txt, and compresses the entire collection into a single ZIP file ready for sale.
+
+🛠️ How to Use
+
+Upload: Drag and drop your source audio file (WAV, MP3, FLAC) into the Audio Input box.
+
+Configure Separation: Select the stem model that suits your track (e.g., '4-Stems' for standard production).
+
+Adjust Sensitivity: Use the slider to fine-tune how aggressively the tool detects transients for one-shot extraction.
+
+Generate: Click the 🚀 Generate Loop Pack button and wait for the processing to complete. The status box will guide you through the process, from analysis to final packaging.
+
+Download: Download the final ZIP file, which is named with the detected BPM and Key (e.g., PRO_LOOP_PACK_128BPM_CMinor.zip).
+
+⚠️ Important Note on Spleeter
+
+This application relies on the powerful spleeter library for stem separation. If you are running this locally or encounter errors on the Space, please ensure that spleeter and its dependencies are properly installed and configured.