Gradio State Docs

New to Gradio? Start here: Getting Started

To install Gradio from main, run the following command:

pip install https://gradio-builds.s3.amazonaws.com/3ab30eefe0cfd2e9c4a23989381e5c583a92c69d/gradio-4.29.0-py3-none-any.whl

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

gradio.State(···)

A base class for defining methods that all input/output components should have.

As input component: Passes a value of arbitrary type through.

Your function should accept one of these types:

def predict(
	value: Any
)
	...

As output component: Expects a value of arbitrary type, as long as it can be deepcopied.

Your function should return one of these types:

def predict(···) -> Any
	...	
	return value

Parameter	Description
`value` Any default: None	the initial value (of arbitrary type) of the state. The provided argument is deepcopied. If a callable is provided, the function will be called whenever the app loads to set the initial value of the state.
`render` bool default: True	has no effect, but is included for consistency with other components.
`time_to_live` int \| float \| None default: None	The number of seconds the state should be stored for after it is created or updated. If None, the state will be stored indefinitely. Gradio automatically deletes state variables after a user closes the browser tab or refreshes the page, so this is useful for clearing state for potentially long running sessions.
`delete_callback` Callable[[Any], None] \| None default: None	A function that is called when the state is deleted. The function should take the state value as an argument.