The Audio class allows you to display an audio player for a specific audio file in the chatbot user interface.

You must provide either an url or a path or content bytes.

Attributes

name
str

The name of the audio file to be displayed in the UI. This is shown to users.

display
ElementDisplay

Determines where the element should be displayed in the UI. Choices are “side” (default), “inline”, or “page”.

url
str

The remote URL of the audio.

path
str

The local file path of the audio.

content
bytes

The file content of the audio in bytes format.

auto_play
bool

Whether the audio should start playing automatically.

Example

import chainlit as cl


@cl.on_chat_start
async def main():
    elements = [
        cl.Audio(name="example.mp3", path="./example.mp3", display="inline"),
    ]
    await cl.Message(
        content="Here is an audio file",
        elements=elements,
    ).send()