README.md

Gradio Lite Extension for Quarto

Enable embedding entirely serverless, browser-based Gradio applications and coding playgrounds in your Quarto documents.

quarto-gradio is an extension that embeds Gradio Lite apps into HTML documents, allowing your Python applications to run directly within your web browser without the need for a server.

• 🌐 100% browser-based, Pyodide-powered, no Python server required
• 📓 Supports all Quarto input formats including Jupyter Notebooks
• ⚡ Supports all HTML-based output formats including Reveal.js presentations
• 📚 Comes with interactive documentation

Installing

quarto add peter-gy/quarto-gradio

This will install the extension under the _extensions subdirectory. If you're using version control, you will want to check in this directory.

Using

This extension is implemented as a Quarto filter. Once registered, it works out of the box with Python code blocks and can be customized further via top-level metadata in the document's frontmatter as well as via cell options specified within comments at the top of code blocks.

This extension was designed to work both with documents written in Quarto Markdown and Jupyter Notebooks; therefore, it is possible to iterate on your Gradio app's code in a convenient, traditional server-based Jupyter environment and distribute your notebook as a static, completely serverless web bundle.

Tip

The extension allows advanced configuration via cell options. For example, specifying #| gr-playground: true transforms the Gradio Lite interface into an interactive coding playground.

Playground Mode

---
title: "Quarto 🔹🔸 Gradio Lite"

filters:
  - gradio
---

```{python}
#| gr-theme: light
#| gr-playground: true
#| gr-layout: vertical
import gradio as gr

def greet(name):
    return f"Hello {name}!"

gr.Interface(fn=greet, inputs="textbox", outputs="textbox", live=True).launch()
```

Application Mode

---
title: "Quarto 🔹🔸 Gradio Lite"

filters:
  - gradio
---

```{python}
#| gr-theme: light
import gradio as gr

def greet(name):
    return f"Hello {name}!"

gr.Interface(fn=greet, inputs="textbox", outputs="textbox", live=True).launch()
```

Example

Here is the source code of a minimal example: example.qmd.

For more detailed guide, further examples and rendered output, please refer to the documentation site.

Design

The main idea behind this extension is to hook into the lifecycle of the Quarto document at the stage where it is represented as a Pandoc Abstract Syntax Tree (AST), collect all the source code from Python code blocks and dynamically construct the appropriate HTML tree by populating the <gradio-requirements/> and <gradio-lite/> tags.