Modos de computación de PyGWalker

Usa computation para elegir dónde ejecuta PyGWalker las consultas de datos. kernel_computation, cloud_computation y use_kernel_calc son flags heredados de compatibilidad y están programados para eliminarse en PyGWalker 0.7.0.

import pygwalker as pyg
 
walker = pyg.walk(df, spec_path="./gw_config.json", computation="kernel")

Matriz de modos

Valor de `computation`	Comportamiento interno	Úsalo cuando
omitido	Conserva el comportamiento automático	Quieres que PyGWalker mantenga su selección predeterminada.
`"auto"`	Conserva el comportamiento automático	Quieres ser explícito sin forzar un backend.
`"browser"`	Computación en frontend/navegador	Necesitas HTML estático o tienes datos locales más pequeños.
`"kernel"`	Computación Python local basada en DuckDB	Necesitas datos locales más grandes en una sesión activa de notebook, Streamlit, Gradio o webserver.
`"cloud"`	Computación cloud de Kanaries	Quieres computación respaldada por cloud con una clave API de Kanaries.

Ejemplos recomendados

Para salida estática o solo frontend, elige computación browser.

html = pyg.to_html(df, spec_path="./gw_config.json", computation="browser")

Para una sesión activa de notebook o app con datos locales más grandes, elige computación kernel.

walker = pyg.walk(df, spec_path="./gw_config.json", computation="kernel")

Para computación cloud, elige el modo cloud y pasa tu clave API.

walker = pyg.walk(
    df,
    spec_path="./gw_config.json",
    computation="cloud",
    kanaries_api_key="...",
)

Flags heredados

Opción heredada	Reemplazo	Estado
`kernel_computation=True`	`computation="kernel"`	Obsoleto, programado para eliminarse en PyGWalker `0.7.0`.
`kernel_computation=False`	`computation="browser"`	Obsoleto, programado para eliminarse en PyGWalker `0.7.0`.
`cloud_computation=True`	`computation="cloud"`	Obsoleto, programado para eliminarse en PyGWalker `0.7.0`.
`use_kernel_calc=True`	`computation="kernel"`	Obsoleto, programado para eliminarse en PyGWalker `0.7.0`.
`use_kernel_calc=False`	`computation="browser"`	Obsoleto, programado para eliminarse en PyGWalker `0.7.0`.

Los flags heredados aún funcionan por compatibilidad y emiten advertencias de obsolescencia. La documentación nueva y el código nuevo deberían usar computation.

Regla de conflicto

No mezcles un valor computation no automático con flags heredados habilitados.

# Raises ValueError.
pyg.walk(df, computation="browser", kernel_computation=True)

Expresa la intención de una sola forma:

pyg.walk(df, computation="browser")

Limitaciones del HTML estático

Las exportaciones HTML estáticas no pueden llamar a un kernel Python activo ni a un servicio cloud. Lo siguiente se rechaza:

pyg.to_html(df, computation="kernel")
pyg.to_html(df, computation="cloud")
pyg.to_html(df, kernel_computation=True)
pyg.to_html(df, cloud_computation=True)
pyg.to_html(df, use_kernel_calc=True)

Usa computación browser para exportaciones estáticas:

html = pyg.to_html(df, spec_path="./gw_config.json", computation="browser")

Usa API para notebooks, Streamlit, Gradio o una sesión webserver cuando necesites computación kernel o cloud activa.

Notas por adaptador

Adaptador	Notas de computación
`pyg.walk`, `pyg.render`, `pyg.table`	Aceptan `computation`; enrutan a adaptadores de notebook en Jupyter y a adaptadores webserver fuera de él.
`pyg.Walker`	Almacena el modo de computación para reutilización. Los métodos de exportación estática aún rechazan modos kernel/cloud activos.
`pygwalker.api.anywidget.walk`	Usa comportamiento kernel de forma predeterminada cuando se usa modo automático en contextos de widget de notebook.
`StreamlitRenderer`	Usa comportamiento kernel de forma predeterminada cuando se usa modo automático; acepta `computation="browser"`, `"kernel"` o `"cloud"`.
`get_html_on_gradio`	Acepta `computation` y modos de backend activos.
`pyg.to_html`	Solo browser/estático.
Adaptador Reflex	Rechaza computación kernel y cloud; usa `computation="browser"`.

Guías relacionadas

API para notebooks Streamlit