Update README.md

README.md

@@ -1,5 +1,673 @@
----
-license: other
-license_name: stabilityai-community-license
-license_link: LICENSE
----
+---
+language: en
+tags:
+- audio
+- music-generation
+- sample-generation
+- EDM
+- Audio-to-Audio
+- fine-tuning
+- stable-audio
+datasets:
+- custom
+model_name: Audialab - EDM Elements 2024
+base_model: stabilityai/stable-audio-open-1.0
+license: other
+license_name: stabilityai-community-license
+license_link: https://stability.ai/license
+---
+
+
+<center><img src="https://i.imgur.com/T8diXrL.jpeg" alt="DS Image" width="120%"></center>
+
+<center>
+  <h2 style="font-size: 30px;"><u>Audialab - EDM Elements 2024</u></h2>
+</center>
+<center>
+  <h2 style="font-size: 19px;">Introduction</h2>
+</center>
+This model specializes in generating high quality key-locked and tempo synced samples to support granular music production workflows. It features <b></b>high musicality, robust Audio-to-Audio capabilities and is capable of generating several effects with each sample.</b> The model can generate an infinite variety of musical components with a specialization in supersaw chord progressions, top line melody leads, bell plucks, and bass pluck riffs. All output is BPM-synced and key-locked to any note within the 12-tone chromatic scale, in both major and minor keys. Developed over several weeks, this model was trained on a custom internal dataset and features several distinct sound types:
+
+<table style="width: 100%; border-collapse: collapse; margin: 20px 0;">
+  <tr>
+    <th style="border: 1px solid #000; padding: 12px; text-align: left; background-color: #f2f2f2;">Sound Description</th>
+    <th style="border: 1px solid #000; padding: 12px; text-align: center; background-color: #f2f2f2;">Audio</th>
+  </tr>
+  <tr>
+    <td style="border: 1px solid #000; padding: 12px; font-weight: bold;">1. Sine / Bell Plucks</td>
+    <td style="border: 1px solid #000; padding: 12px; text-align: center;">
+      <audio controls style="width: 200px;">
+        <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Sine%2C%20Bell%2C%20Pluck%2C%20chord%20progression%20with%20slow%20melody%2C%20B%20minor%2C%20high%20reverb%2C%20rising%20low-pass%2C%208%20bars%2C%20140BPM%2C%202.mp3" type="audio/mpeg">
+        Your browser does not support the audio element.
+      </audio>
+    </td>
+  </tr>
+  <tr>
+    <td style="border: 1px solid #000; padding: 12px; font-weight: bold;">2. Lead Square Legato Synth</td>
+    <td style="border: 1px solid #000; padding: 12px; text-align: center;">
+      <audio controls style="width: 200px;">
+        <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/legato_ex_1.mp3" type="audio/mpeg">
+        Your browser does not support the audio element.
+      </audio>
+    </td>
+  </tr>
+  <tr>
+    <td style="border: 1px solid #000; padding: 12px; font-weight: bold;">3. Lead Square Warm Synth</td>
+    <td style="border: 1px solid #000; padding: 12px; text-align: center;">
+      <audio controls style="width: 200px;">
+        <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Synth%2C%20saw%2C%20fast%20speed%2C%20falling%20arp%2C%20medium%20reverb%2C%20falling%20high-cut%2C%20C%20major%2C%204%2C%20150%2C%201.mp3" type="audio/mpeg">
+        Your browser does not support the audio element.
+      </audio>
+    </td>
+  </tr>
+  <tr>
+    <td style="border: 1px solid #000; padding: 12px; font-weight: bold;">4. Bass Plucks</td>
+    <td style="border: 1px solid #000; padding: 12px; text-align: center;">
+      <audio controls style="width: 200px;">
+        <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Sine%2C%20Bass%2C%20Bounce%2C%20Catchy%20Melody%2C%20G%20minor%2C%208%20bars%2C%20110BPM%2C%203.mp3" type="audio/mpeg">
+        Your browser does not support the audio element.
+      </audio>
+    </td>
+  </tr>
+  <tr>
+    <td style="border: 1px solid #000; padding: 12px; font-weight: bold;">5. Supersaw Leads & Chord Progressions</td>
+    <td style="border: 1px solid #000; padding: 12px; text-align: center;">
+      <audio controls style="width: 200px;">
+        <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Supersaw%2C%20dance%20chord%20progression%2C%20top%20triplet%20melody%2C%20F%23%20minor%2C%20medium%20reverb%2C%2C%208%20bars%2C%20130BPM%2C%202.mp3" type="audio/mpeg">
+        Your browser does not support the audio element.
+      </audio>
+    </td>
+  </tr>
+</table>
+
+Furthermore, <b>the model is capable of generating multiple post-processing effects, </b> with <i>several</i> different levels of control based on the prompt alone. All effects can be prompted <b>individually or together.</b>
+
+- **1. Reverb** - Small Reverb, Medium Reverb, High Reverb
+- **2. EQ Sweeps** - Rising Low-Pass, Falling High-Cut
+- **3. Gate Effect** - Quarter-Beat gate, Half-Beat Gate
+
+<b>The model has high Audio-To-Audio / Style Transfer capabilities.</b> For example you can upload a .wav sample and have the model turn the sample into say a Supersaw version with a rising low-pass.
+
+<div style="text-align: center; margin: 20px 0;">
+  <table style="width: 100%; border-collapse: collapse; margin: 0 auto;">
+    <thead>
+      <tr>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">Prompt</th>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">Settings</th>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">Before</th>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">After</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          Supersaw, high reverb, rising low-pass 
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <b>CFG:</b> 10.0 / <b>Noise:</b> 1.29
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/a2a_1_in.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/a2a_1_in_130a2a_out_%20Supersaw%2C%20high%20reverb%2C%20rising%20low-pass%20CFG%2010%20noise%201_29.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+ 
+<center>
+  <h2 style="font-size: 19px;">Model Features</h2>
+</center>
+
+- **Multiple Types of Sample Generation:** - Outputs multiple types of high quality EDM-Centric samples with several variations on melody and chord progressions.
+- **Dynamic FX Chain:** - Add multiple effects based on prompt alone (prompts above) - i.e add "Medium Reverb" for a medium reverb effect on the output. 
+- **Tonal Versatility:** - Generates stems in any key across the 12-tone chromatic scale, in both major and minor scales.
+- **Triplet Time Signature Support:** - Add "triplets" to any prompt and get triplet outputs.
+- **AI Style Trasnfer / Audio to Audio:** - The model has robust AI Style Transfer capabilities.
+- **Speed Controls Independent of BPM:** - The model can be prompted with "Slow Speed", "Medium Speed" & "Fast Speed" that is independent of BPM. i.e. ask for an arp at a "Fast speed" at 140BPM vs "slow speed" at 140BPM and the model will subdivide the notes accordingly while staying within the same bpm.
+- **Simplified Scale Notation:** - Scales are written using <b><i>sharps only</i></b> in the following format:
+
+<pre>
+<b>Minor Scales</b>
+A minor, A# minor, B minor, C minor, C# minor, D minor, D# minor,
+E minor, F minor, F# minor, G minor, G# minor
+
+<b>Major Scales</b>
+A major, A# major, B major, C major, C# major, D major, D# major,
+E major, F major, F# major, G major, G# major
+</pre>
+
+
+<center>
+  <h2 style="font-size: 19px;">Training Methodology</h2>
+</center>
+
+This model was designed to understand and generate several types of samples:
+1. **Chord Progression Samples**
+2. **Chord Progression with Melody Samples**
+3. **Melody Only Samples**
+4. **Supersaw Dance Chord Progressions**
+5. **Bass Plucks / Riffs**
+6. **Arps**
+
+
+By exposing the model to various musical motifs and distinct sample differences, it has SOTA musicality and melody structure with output samples ready to use in music production.
+
+<center>
+  <h2 style="font-size: 24px;"><u>Prompt Structure</u></h2>
+</center>
+
+Both the Audialab Engine (VST) and RC Github fork are best used when working with this model. The RC Github also features a randomized prompt button tuned to this models metadata. 
+
+If you wish to prompt outside of these interfaces - then to ensure the best results use the following format for your prompts:
+<pre><b>
+[Sound Type], [Modifier][Chord Progression], [Modifier][Melody Type], [Key], [FX], [BPM], [Bar Count]
+</b></pre>
+
+[Sound Type Prompts]
+- **1. Bell Plucks:** - 'Pluck, Sine, Bright, Clean, Bell' 
+- **2. Lead Square Legato Synth** - 'Lead, Square, Synth, Buzzy, Legato'
+- **3. Lead Square Warm Synth** - 'Lead, Saw, Synth, Warm, Supersaw'
+- **4. Pluck Bass** - 'Bass, Punchy, Pluck, Clean, Sub, Sine'
+- **5. Supersaw Leads & Chord Progressions**  'Supersaw, Synth, Warm, Saw'
+
+<b><u>Major prompt terms and their effects</u></b>
+- **Chord Progression** - produces chord progressions
+- **Arp** - produces arps
+- **Melody** - adds melodies
+- **Triplets** - outputs triplet time
+- **Bounce**  - more syncopassion/ off beat rhythm
+- **Epic** - encourages more interesting melodic output
+- **Simple** -  slower / simpler melodies / chord progressions
+- **Slow speed** - slower chord progressions, arps and melodies
+- **Medium speed** - encouraged 4/4 chord changes or melodies
+- **Fast speed** - higher subdivisions / faster arps and melodies
+- **Complex** - adds complex melodies or chord structure.
+- **Rising** - encourages rising arps / melodies
+- **Falling** - encourages falling arps / melodies
+- **See random prompt document for further terms / examples** [HERE](./prompt_list_examples.md)
+
+<center>
+  <h2 style="font-size: 20px;"><u>Prompt Examples with Audio</u></h2>
+</center>
+<!-- Audio Examples Table -->
+<div style="text-align: center; margin: 20px 0;">
+  <table style="width: 100%; border-collapse: collapse; margin: 0 auto;">
+    <thead>
+      <tr>
+        <th style="border: 1px solid #000; padding: 8px; text-align: left;">Prompt</th>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">Example 1</th>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">Example 2</th>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">Example 3</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: left;">
+          <b>Bell pluck,</b> chord progression, top catchy melody, E major, <b>high reverb,</b> 8 bars, 100BPM
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Bell%20pluck%2C%20chord%20progression%2C%20top%20catchy%20melody%2C%20E%20major%2C%20%20high%20reverb%2C%208%20bars%2C%20100BPM%2C%201.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Bell%20pluck%2C%20chord%20progression%2C%20top%20catchy%20melody%2C%20E%20major%2C%20%20high%20reverb%2C%208%20bars%2C%20100BPM%2C%202.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Bell%20pluck%2C%20chord%20progression%2C%20top%20catchy%20melody%2C%20E%20major%2C%20%20high%20reverb%2C%208%20bars%2C%20100BPM%2C%203.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: left;">
+          <b>Saw, supersaw,</b> chord progression, top melody, E minor, <b>rising low-pass,</b> 4 bars, 128BPM
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Saw%2C%20supersaw%2C%20chord%20progression%2C%20top%20melody%2C%20E%20minor%2C%20rising%20low-pass%2C%20%2C%204%20bars%2C%20128BPM%2C%201.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Saw%2C%20supersaw%2C%20chord%20progression%2C%20top%20melody%2C%20E%20minor%2C%20rising%20low-pass%2C%20%2C%204%20bars%2C%20128BPM%2C%202.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Saw%2C%20supersaw%2C%20chord%20progression%2C%20top%20melody%2C%20E%20minor%2C%20rising%20low-pass%2C%20%2C%204%20bars%2C%20128BPM%2C%203.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: left;">
+          <b>Sine, Bass,</b> Bounce, Catchy Melody, G minor, 8 bars, 110BPM
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Sine%2C%20Bass%2C%20Bounce%2C%20Catchy%20Melody%2C%20G%20minor%2C%208%20bars%2C%20110BPM%2C%201.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Sine%2C%20Bass%2C%20Bounce%2C%20Catchy%20Melody%2C%20G%20minor%2C%208%20bars%2C%20110BPM%2C%202.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Sine%2C%20Bass%2C%20Bounce%2C%20Catchy%20Melody%2C%20G%20minor%2C%208%20bars%2C%20110BPM%2C%203.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: left;">
+          <b>Sine, Bell, Pluck,</b> chord progression with slow melody, B minor, <b>high reverb, rising low-pass,</b> 8 bars, 140BPM
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Sine%2C%20Bell%2C%20Pluck%2C%20chord%20progression%20with%20slow%20melody%2C%20B%20minor%2C%20high%20reverb%2C%20rising%20low-pass%2C%208%20bars%2C%20140BPM%2C%201.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Sine%2C%20Bell%2C%20Pluck%2C%20chord%20progression%20with%20slow%20melody%2C%20B%20minor%2C%20high%20reverb%2C%20rising%20low-pass%2C%208%20bars%2C%20140BPM%2C%202.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Sine%2C%20Bell%2C%20Pluck%2C%20chord%20progression%20with%20slow%20melody%2C%20B%20minor%2C%20high%20reverb%2C%20rising%20low-pass%2C%208%20bars%2C%20140BPM%2C%203.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: left;">
+          <b>Supersaw,</b> dance chord progression, top triplet melody, F# minor, <b>medium reverb,</b> 8 bars, 130BPM
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Supersaw%2C%20dance%20chord%20progression%2C%20top%20triplet%20melody%2C%20F%23%20minor%2C%20medium%20reverb%2C%2C%208%20bars%2C%20130BPM%2C%201.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Supersaw%2C%20dance%20chord%20progression%2C%20top%20triplet%20melody%2C%20F%23%20minor%2C%20medium%20reverb%2C%2C%208%20bars%2C%20130BPM%2C%202.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Supersaw%2C%20dance%20chord%20progression%2C%20top%20triplet%20melody%2C%20F%23%20minor%2C%20medium%20reverb%2C%2C%208%20bars%2C%20130BPM%2C%203.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: left;">
+          <b>Synth, saw,</b> fast speed, falling arp, <b>medium reverb, falling high-cut,</b> C major, 4 bars, 150 BPM 
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Synth%2C%20saw%2C%20fast%20speed%2C%20falling%20arp%2C%20medium%20reverb%2C%20falling%20high-cut%2C%20C%20major%2C%204%2C%20150%2C%201.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Synth%2C%20saw%2C%20fast%20speed%2C%20falling%20arp%2C%20medium%20reverb%2C%20falling%20high-cut%2C%20C%20major%2C%204%2C%20150%2C%202.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/Synth%2C%20saw%2C%20fast%20speed%2C%20falling%20arp%2C%20medium%20reverb%2C%20falling%20high-cut%2C%20C%20major%2C%204%2C%20150%2C%203.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: left;">
+          <b>legato, square,</b> catchy melody, <b> high reverb,</b> E minor, 8 bars, 130PM 
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/legato_ex_1.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/legato_ex_2.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/legato_ex_3.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: left;">
+          <b>supersaw,</b> complex, epic, arp, D# minor, 8 bars, 140BPM
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/supersaw%2C%20complex%2C%20epic%2C%20arp%2C%20D%23%20minor%2C%208%20bars%2C%20140BPM%2C%201.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/supersaw%2C%20complex%2C%20epic%2C%20arp%2C%20D%23%20minor%2C%208%20bars%2C%20140BPM%2C%202.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/supersaw%2C%20complex%2C%20epic%2C%20arp%2C%20D%23%20minor%2C%208%20bars%2C%20140BPM%2C%203.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+
+<center>
+  <h2 style="font-size: 20px;"><u>Audio to Audio / Style Transfer Showcase</u></h2>
+</center>
+
+<div style="text-align: center; margin: 20px 0;">
+  <table style="width: 100%; border-collapse: collapse; margin: 0 auto;">
+    <thead>
+      <tr>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">Prompt</th>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">Settings</th>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">Before</th>
+        <th style="border: 1px solid #000; padding: 8px; text-align: center;">After</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          supersaw, medium reverb
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <b>CFG:</b> 9.0 / <b>Noise:</b> 1.16 
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/in_a2a_example_guitar_130_4.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/in_a2a_example_guitar_130_4_output_in_a2a_out_guitar_supersaw%2C%20medium%20reverb%2C%20cfg%209%20noise%201.16%2C.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          Pluck Bell, Medium Reverb
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <b>CFG:</b> 8.2 / <b>Noise:</b> 1.21
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/a2a_example_piano_150_8.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/a2a_out_piano_%20150%20pluck%2C%20bell%2C%20medium%20reverb%20cfg%208_2%20noise%201_21_out.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+      <tr>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          Supersaw, high reverb, rising low-pass 
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <b>CFG:</b> 10 / <b>Noise:</b> 1.29
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/a2a_1_in.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+        <td style="border: 1px solid #000; padding: 8px; text-align: center;">
+          <audio controls style="width: 150px;">
+            <source src="https://huggingface.co/adlb/Audialab_EDM_Elements/resolve/main/audio_examples/a2a_1_in_130a2a_out_%20Supersaw%2C%20high%20reverb%2C%20rising%20low-pass%20CFG%2010%20noise%201_29.mp3" type="audio/mpeg">
+            Your browser does not support the audio element.
+          </audio>
+        </td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+
+
+
+### Prompt Examples
+You can find a handy list of starter prompts [HERE](./prompt_list_examples.md)
+
+
+#### BPMs/Bars:
+
+The BPMs ranged from as low as 100BPM up to 150BPM. The main denominations are **100BPM, 110BPM, 120BPM, 128BPM, 130BPM, 140BPM, 150BPM**.
+
+There are 2 bar settings: **4 bars** and **8 bars**.
+
+<center>
+  <h2 style="font-size: 24px;"><u>Useage Guide</u></h2>
+</center>
+
+<center>
+  <h2 style="font-size: 22px;"><u>VST Support</u></h2>
+</center>
+
+<b>
+<p align="center" style="font-size: 18px;">
+  This model has direct VST compatibility in <a href="https://audialab.com/products/deep-sampler-2/" style="font-size: 20px;">Audialab Engine.</a>
+</b>
+
+
+<center><img src="https://i.imgur.com/q7VqxTZ.jpeg" alt="DS Image" width="60%"></center>
+
+
+<center>
+  <h2 style="font-size: 19px;"><u>Gradio Interfaces</u></h2>
+</center>
+
+
+<b>
+<p align="center" style="font-size: 20px;">
+  You can find a <a href="https://github.com/RoyalCities/RC-stable-audio-tools" style="font-size: 20px;">direct link to a custom GitHub interface here.</a>
+</p>
+
+<p align="center" style="font-size: 20px;">
+  If you wish to use the original Stable Audio Github then you can <a href="https://github.com/Stability-AI/stable-audio-tools" style="font-size: 20px;">follow this link.</a>
+</p>
+</b>
+
+<p align="center" style="font-size: 18px; line-height: 1.5;">
+  <b>
+    You will find 2 checkpoints files in the repo:<br>
+    Audialab_EDM_Elements.ckpt - Full 32 bit model<br>
+    and<br>
+    Audialab_EDM_Elements_Small.ckpt - 16-bit low VRAM version<br>
+    along with the associated config file - model_config.json<br>
+    <br>
+    To use the model you would choose <i>either</i> the full model or the 16-bit quantized model. Once chosen place the .ckpt file and the config .json inside their own sub-folder in the "models" folder and launch the gradio.
+  </b>
+</p>
+
+
+<center>
+  <h2 style="font-size: 24px;"><u>Dataset Breakdown</u></h2>
+</center>
+
+<center>
+  <h2 style="font-size: 19px;">Overview</h2>
+</center>
+
+- **Total .wav files**: 606,976
+- **Total Size**: 58.03 GB (pre-encode)
+- **Sample Rate**: 44100 Hz
+<center>
+  <h2 style="font-size: 19px; text-align: center;">Sample Breakdown</h2>
+</center>
+
+<table align="center" style="width: 80%; border-collapse: collapse; margin: 0 auto; margin-bottom: 30px;">
+  <thead>
+    <tr>
+      <th style="border: 1px solid black; padding: 8px;">Sound Type</th>
+      <th style="border: 1px solid black; padding: 8px;">Sample Count</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>Bell Pluck</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">100,553</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>Warm Supersaw</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">100,320</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>Square Lead</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">54,475</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>Square Buzzy Lead</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">54,845</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>Pluck Bass</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">54,732</td>
+    </tr>
+  </tbody>
+</table>
+
+<center>
+  <h2 style="font-size: 19px; text-align: center;">Augment Breakdown</h2>
+</center>
+
+<table align="center" style="width: 80%; border-collapse: collapse; margin: 0 auto;">
+  <thead>
+    <tr>
+      <th style="border: 1px solid black; padding: 8px;">Augment Category</th>
+      <th style="border: 1px solid black; padding: 8px;">File Count</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>Low Cut Rise w/ Half Gate</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">22,763</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>High Cut Faller w/ Half Gate</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">22,849</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>Reverb Augments</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">90,180</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>Gate Augments</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">30,045</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>High Cut Faller Quarter Bar Gate</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">22,703</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>Low Cut Rise w/ Quarter Gate</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">22,589</td>
+    </tr>
+    <tr>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;"><b>High Cut & Low Cut Augments</b></td>
+      <td style="border: 1px solid black; padding: 8px; text-align: center;">30,922</td>
+    </tr>
+  </tbody>
+</table>
+
+While the dataset appears quite large it featured *heavy augmentation.* For example a single melody could be stretched into multiple keys and multiple tempos with slight changes for variance. This means the training time must be carefully watched to ensure it doesn't overfit
+to specific melodic patterns. 
+
+Further the FX augments used the original stem but with only say a "high reverb" preset applied. This stretches the data further and lets the model hone in one this specific component of the sound (as it's seen both no-FX versions along with identical FX applied versions)
+
+<center>
+  <h2 style="font-size: 19px;">Technical Specifications</h2>
+</center>
+
+- **Platform**: Runpod
+- **Monitoring Tool**: Weights and Biases
+- **Total Steps**: 33,436
+- **Final Checkpoint Step**: 28,452
+- **Learning Rate**: 5e-5
+- **Dataset type**: Pre-encode
+- **Optimizer**: AdamW
+- **Scheduler**: InverseLR
+- **Batch Size**: 32
+- **Hardware**: 2x NVIDIA A40 GPUs
+
+See config file for further details.
+
+<center>
+  <h2 style="font-size: 24px;"><u>Limitations and Biases</u></h2>
+</center>
+
+The model itself has very high musicality and can essentialy be used as an infinite sample + melody generator. A limitation however of the model is since it was created using our own dataset it is not set up for genre prompting and/or sound types outside of the ones mentioned above. i.e. A prompt like "House, Pad, Guitar" would not produce such samples.
+
+In the future with scale - genre prompting and additional sound types can be released in future models.
+
+Lastly as mentioned it has very robust audio-to-audio capabilities however the input audio should be within a similiar frequency space as the desired output. For example if you had a piano progression and wanted to change it to a supersaw then it will do very well. But if you put a bass sample as the input (which usually falls within the lower frequency spectrum) and ask for a supersaw version (which falls within the mid-to high frequency) then the model
+will struggle with the conversion. A workaround is to pitch the input sample up or down to get near to the desired output frequency range. i.e. if you wanted to AI style transfer a piano melody to a bass pluck then pitching the input piano sample down a few semitones and then converting to bass will have better results.
+
+<center>
+  <h2 style="font-size: 24px;"><u>Additional details</u></h2>
+</center>
+
+- **Dataset:** Internal IP + Tooling
+- **Gate Module:** Custom NumPy FX
+- **Reverb Effect** Solaris Reverb
+- **EQ:** Simple EQ Effect (riser/faller)
+
+<center>
+  <h2 style="font-size: 24px;"><u>License</u></h2>
+</center>
+
+
+This model is licensed under the Stability AI Community License. It is available for non-commercial use or limited commercial use by entities with annual revenues below USD $1M. For revenues exceeding USD $1M, please refer to the [LICENSE](./LICENSE.md) for detailed terms.