Introducing Gradio Clients

Watch
  1. Helpers
  2. load

New to Gradio? Start here: Getting Started

See the Release History

load

gradio.load(···)

Description

Constructs a demo from a Hugging Face repo. Can accept model repos (if src is "models") or Space repos (if src is "spaces"). The input and output components are automatically loaded from the repo. Note that if a Space is loaded, certain high-level attributes of the Blocks (e.g. custom css, js, and head attributes) will not be loaded.

Example Usage

import gradio as gr
demo = gr.load("gradio/question-answering", src="spaces")
demo.launch()

Initialization

Parameters
name: str

the name of the model (e.g. "gpt2" or "facebook/bart-base") or space (e.g. "flax-community/spanish-gpt2"), can include the `src` as prefix (e.g. "models/facebook/bart-base")

src: str | None
default = None

the source of the model: `models` or `spaces` (or leave empty if source is provided as a prefix in `name`)

hf_token: str | Literal[False] | None
default = False

optional Hugging Face token for loading private models or Spaces. By default, no token is sent to the server, set `hf_token=None` to use the locally saved token if there is one (warning: when loading Spaces, only provide a token if you are loading a trusted private Space as the token can be read by the Space you are loading). Find your tokens here: https://huggingface.co/settings/tokens.

alias: str | None
default = None

optional string used as the name of the loaded model instead of the default name (only applies if loading a Space running Gradio 2.x)