Skip to content

API de PyGWalker para Gradio

Usa get_html_on_gradio para generar HTML de iframe de PyGWalker para una app de Gradio. Monta PYGWALKER_ROUTE al lanzar la app para que las rutas de comunicación de PyGWalker estén disponibles.

import gradio as gr
import pandas as pd
from pygwalker.api.gradio import PYGWALKER_ROUTE, get_html_on_gradio
 
df = pd.read_csv("data.csv")
 
with gr.Blocks() as demo:
    pyg_html = get_html_on_gradio(
        df,
        spec_path="./gw_config.json",
        spec_io_mode="rw",
        computation="kernel",
    )
    gr.HTML(pyg_html)
 
demo.launch(app_kwargs={"routes": [PYGWALKER_ROUTE]})

get_html_on_gradio

Firma:

get_html_on_gradio(
    dataset,
    gid=None,
    *,
    field_specs=None,
    theme_key="g2",
    appearance="media",
    spec="",
    spec_path=None,
    spec_io_mode="r",
    computation=None,
    kernel_computation=None,
    kanaries_api_key="",
    default_tab="vis",
    **kwargs,
) -> str

dataset puede ser un pandas DataFrame, polars DataFrame, pyarrow Table o Connector de base de datos.

Opciones clave

OpciónPredeterminadoNotas
spec_pathNoneArchivo local de estado de gráficos. Prefiere esta opción para archivos locales.
spec_io_mode"r"Usa "rw" cuando la UI de Gradio deba guardar ediciones de gráficos.
computationNoneUsa "browser", "kernel" o "cloud" para elegir explícitamente.
kernel_computationNoneFlag heredado de compatibilidad. Prefiere computation; la eliminación está programada para PyGWalker 0.7.0.
default_tab"vis"Pestaña inicial del explorador.

Notas de computación

Gradio se ejecuta como una app activa, por lo que la computación kernel y cloud está admitida.

get_html_on_gradio(df, computation="browser")
get_html_on_gradio(df, computation="kernel")
get_html_on_gradio(df, computation="cloud", kanaries_api_key="...")

No mezcles un valor computation no automático con flags heredados de computación habilitados. PyGWalker genera ValueError cuando esas opciones entran en conflicto.

Errores comunes

ErrorSolución
El iframe se renderiza pero las interacciones fallanLanza con app_kwargs={"routes": [PYGWALKER_ROUTE]}.
Las ediciones locales de gráficos no se guardanUsa spec_path más spec_io_mode="rw".
El código nuevo usa kernel_computation=TrueUsa computation="kernel".
Se necesita una exportación HTML estática en lugar de una app de GradioUsa Exportaciones HTML con computation="browser".

Guías relacionadas