value |
```python
str | bytes | Callable | None
```
|
value = None |
Default MIDI file to display, given as a str file path, URL, or bytes. |
bpm |
```python
int
```
|
value = 120 |
The tempo to use when creating MIDI files from recorded messages. Defaults to 120. |
label |
```python
str | I18nData | None
```
|
value = None |
The label for this component. |
every |
```python
Timer | float | None
```
|
value = None |
Continuously calls `value` to recalculate it if `value` is a function. |
inputs |
```python
Component | Sequence[Component] | set[Component] | None
```
|
value = None |
Components that are used as inputs to calculate `value` if `value` is a function. |
show_label |
```python
bool | None
```
|
value = None |
If True, will display label. |
container |
```python
bool
```
|
value = True |
If True, will place the component in a container. |
scale |
```python
int | None
```
|
value = None |
Relative size compared to adjacent Components. |
min_width |
```python
int
```
|
value = 160 |
Minimum pixel width. |
height |
```python
int | str | float | None
```
|
value = None |
The height of the component. |
interactive |
```python
bool | None
```
|
value = None |
If True, will allow users to interact with MIDI devices. |
visible |
```python
bool | Literal['hidden']
```
|
value = True |
If False, component will be hidden. |
elem_id |
```python
str | None
```
|
value = None |
An optional string that is assigned as the id of this component in the HTML DOM. |
elem_classes |
```python
list[str] | str | None
```
|
value = None |
An optional list of strings that are assigned as the classes of this component. |
render |
```python
bool
```
|
value = True |
If False, component will not render in the Blocks context. |
key |
```python
int | str | tuple[int | str, ...] | None
```
|
value = None |
In a gr.render, Components with the same key across re-renders are treated as the same component. |
preserved_by_key |
```python
list[str] | str | None
```
|
value = "value" |
A list of parameters from this component's constructor to preserve across re-renders. |
Human AI Jam Sessions with Music LLMs
## Installation
```bash
pip install gradio_midijamsession
```
## Usage
```python
"""
Demo app for MidiJamSession component.
Transposes all incoming MIDI notes by +2 semitones.
"""
import gradio as gr
from gradio_midijamsession import MidiJamSession
import io
from processor import transpose_midi
# Create the Gradio interface
with gr.Blocks(title="MIDI Jam Session Demo") as demo:
gr.Markdown("""
# 🎹 MIDI Jam Session Demo
This demo shows the MidiJamSession component in action:
1. **Select your MIDI input device** - Connect your MIDI keyboard or controller
2. **Select your MIDI output device** - Choose where to send the processed MIDI
3. **Play some notes** - The component will record your input
4. **Wait 5 seconds** - After inactivity, the recording is sent for processing
5. **Listen to the result** - Notes are transposed up by 2 semitones and played back
## How it works
- The frontend uses the **Web MIDI API** to capture live MIDI input
- After 5 seconds of inactivity, the recording is converted to a MIDI file using **@tonejs/midi**
- The backend receives the MIDI file and uses **mido** to transpose all notes by +2 semitones
- The processed MIDI is sent back and played on your selected output device
""")
midi_session = MidiJamSession(
label="MIDI Jam Session",
bpm=120,
interactive=True,
)
# Connect the processing function
midi_session.change(
fn=transpose_midi,
inputs=midi_session,
outputs=midi_session,
)
if __name__ == "__main__":
demo.launch()
```
## `MidiJamSession`
### Initialization