Helpers
Progress

New to Gradio? Start here: Getting Started

To install Gradio from main, run the following command:

pip install https://gradio-builds.s3.amazonaws.com/b23f75302170144e59a61cf918fc764221afa3f9/gradio-5.34.2-py3-none-any.whl

*Note: Setting share=True in launch() will not work.

←

Examples

Dependency

→

Progress

gradio.Progress(···)

Description

The Progress class provides a custom progress tracker that is used in a function signature. To attach a Progress tracker to a function, simply add a parameter right after the input parameters that has a default value set to a `gradio.Progress()` instance. The Progress tracker can then be updated in the function by calling the Progress object or using the `tqdm` method on an Iterable.

Example Usage

import gradio as gr
import time
def my_function(x, progress=gr.Progress()):
    progress(0, desc="Starting...")
    time.sleep(1)
    for i in progress.tqdm(range(100)):
        time.sleep(0.1)
    return x
gr.Interface(my_function, gr.Textbox(), gr.Textbox()).queue().launch()

Initialization

🔗

track_tqdm: bool

default = False

If True, the Progress object will track any tqdm.tqdm iterations with the tqdm library in the function.

Methods

call

gradio.Progress.__call__(progress, ···)

Description

Updates progress tracker with progress and message text.

🔗

progress: float | tuple[int, int | None] | None

If float, should be between 0 and 1 representing completion. If Tuple, first number represents steps completed, and second value represents total steps or None if unknown. If None, hides progress bar.

🔗