Describe what each control does to the sound

app.py

@@ -405,7 +405,10 @@ if __name__ == "__main__":
                     label="input audio",
                     interactive=False, 
                     type="numpy",
-                )
+                ).set_info((
+                    "The audio to rework. The model fills in what it masks out, so the "
+                    "result keeps the character of this recording."
+                ))
 
                 # audio_mask = gr.Audio(
                 #     label="audio mask (listen to this to hear the mask hints)",
@@ -435,7 +438,12 @@ if __name__ == "__main__":
                         minimum=0,
                         maximum=13, 
                         step=1,
-                        value=7, 
+                        value=7,
+                        info=(
+                            "How much of the original is kept as a guide. Low values keep more "
+                            "and stay closer to the input; high values free the model to depart "
+                            "from it."
+                        ), 
                     )
 
                     onset_mask_width = gr.Slider(
@@ -461,6 +469,10 @@ if __name__ == "__main__":
                         minimum=1, 
                         maximum=14,
                         step=1,
+                        info=(
+                            "Keeps only the coarsest detail of the original, discarding fine "
+                            "timbre. Raise it for a looser reinterpretation."
+                        ),
                     )
 
                     dropout = gr.Slider(
@@ -468,7 +480,11 @@ if __name__ == "__main__":
                         minimum=0.0,
                         maximum=1.0,
                         step=0.01,
-                        value=0.0
+                        value=0.0,
+                        info=(
+                            "Randomly drops parts of the guide, which loosens the result "
+                            "without changing the overall amount kept."
+                        )
                     )
 
                     num_feedback_steps = gr.Slider(
@@ -482,7 +498,8 @@ if __name__ == "__main__":
                     preset_dropdown = gr.Dropdown(
                         label="preset",
                         choices=["timbre transfer", "small variation", "small variation (follow beat)", "medium variation", "medium variation (follow beat)", "large variation", "large variation (follow beat)", "unconditional"],
-                        value="medium variation"
+                        value="medium variation",
+                        info="Loads a set of the controls below that is known to work together."
                     )
                     def change_preset(preset_dropdown):
                         if preset_dropdown == "timbre transfer":
@@ -554,6 +571,7 @@ if __name__ == "__main__":
                         maximum=12,
                         step=1,
                         value=0,
+                        info="Shifts the input before processing. Twelve is one octave.",
                     )
 
                     stretch_factor = gr.Slider(
@@ -561,7 +579,11 @@ if __name__ == "__main__":
                         minimum=0,
                         maximum=8, 
                         step=1,
-                        value=1, 
+                        value=1,
+                        info=(
+                            "Stretches the input before processing. Values above one slow it "
+                            "down."
+                        ), 
                     )
 
 
@@ -573,18 +595,30 @@ if __name__ == "__main__":
                         minimum=0.1,
                         maximum=10.0,
                         value=1.0, 
-                        step=0.001
+                        step=0.001,
+                        info=(
+                            "How adventurous the choices are. Higher values wander further and "
+                            "can lose the beat."
+                        )
                     )
             
                     top_p = gr.Slider(
                         label="top p (0.0 = off)",
                         minimum=0.0,
                         maximum=1.0,
-                        value=0.0
+                        value=0.0,
+                        info=(
+                            "Restricts choices to the most likely ones. Lower values are safer "
+                            "and more repetitive."
+                        )
                     )
                     typical_filtering = gr.Checkbox(
                         label="typical filtering ",
-                        value=True
+                        value=True,
+                        info=(
+                            "An alternative to top p that keeps choices of average likelihood, "
+                            "avoiding both the safest and the strangest."
+                        )
                     )
                     typical_mass = gr.Slider( 
                         label="typical mass (should probably stay between 0.1 and 0.5)",
@@ -604,14 +638,19 @@ if __name__ == "__main__":
                         minimum=0.0,
                         maximum=0.9,
                         value=1.0, 
-                        step=0.01
+                        step=0.01,
+                        info=(
+                            "Stops sampling early, leaving later detail to the decoder. Lower "
+                            "values are smoother and less detailed."
+                        )
                     )
                     sampling_steps = gr.Slider(
                         label="sampling steps",
                         minimum=1,
                         maximum=128,
                         step=1,
-                        value=36
+                        value=36,
+                        info="More steps give a more considered result and take longer."
                     )
 
 
@@ -620,6 +659,10 @@ if __name__ == "__main__":
                     label="seed (0 for random)",
                     value=0,
                     precision=0,
+                    info=(
+                        "Fixes the result, so the same seed and settings give the same "
+                        "output."
+                    ),
                 )
 
 
@@ -630,7 +673,11 @@ if __name__ == "__main__":
                     label="model choice", 
                     choices=list(interface.available_models()),
                     value=init_model_choice, 
-                    visible=True
+                    visible=True,
+                    info=(
+                        "Which fine-tune to use. Each was trained on different material, "
+                        "named in the model card."
+                    )
                 )