{"id":6800,"library":"pygwalker","title":"Pygwalker","description":"Pygwalker (Python Graphic Walker) is a Python library that transforms pandas (and Polars) DataFrames into an interactive, Tableau-style user interface for data exploration and visualization directly within Jupyter Notebooks, Google Colab, and other compatible environments. It simplifies data analysis and visualization workflows by enabling drag-and-drop operations for quick visual insights. The library is actively developed, with the current version being 0.5.0.1, and sees regular updates to enhance features and performance.","status":"active","version":"0.5.0.1","language":"en","source_language":"en","source_url":"https://github.com/Kanaries/pygwalker","tags":["data-analysis","data-exploration","dataframe","jupyter","pandas","tableau","visualization","streamlit","gradio","polars"],"install":[{"cmd":"pip install pygwalker","lang":"bash","label":"Standard installation"},{"cmd":"pip install \"pygwalker[snowflake]\"","lang":"bash","label":"With Snowflake support"}],"dependencies":[{"reason":"Core data structure for `pyg.walk()` input.","package":"pandas","optional":false},{"reason":"Provides the interactive UI within Jupyter environments.","package":"ipywidgets","optional":false},{"reason":"Used as the computation engine when `kernel_computation=True` for improved performance with larger datasets.","package":"duckdb","optional":true},{"reason":"Required for building web applications with Streamlit using `StreamlitRenderer`.","package":"streamlit","optional":true},{"reason":"Required for connecting to Snowflake when using the `snowflake` extra.","package":"snowflake-connector-python","optional":true}],"imports":[{"symbol":"pygwalker","correct":"import pygwalker as pyg"},{"note":"Required for integrating Pygwalker into Streamlit applications.","symbol":"StreamlitRenderer","correct":"from pygwalker.api.streamlit import StreamlitRenderer"},{"note":"Used for connecting to database sources like Snowflake directly.","symbol":"Connector","correct":"from pygwalker.data_parsers.database_parser import Connector"}],"quickstart":{"code":"import pandas as pd\nimport pygwalker as pyg\n\n# Create a sample DataFrame\ndata = {\n    'City': ['New York', 'Los Angeles', 'Chicago', 'Houston', 'Phoenix'],\n    'Population': [8804190, 3898747, 2716075, 2325502, 1680992],\n    'Area_sq_mi': [302.6, 468.7, 227.6, 637.4, 517.6]\n}\ndf = pd.DataFrame(data)\n\n# Launch Pygwalker UI\n# You can also use pyg.walk(df, kernel_computation=True) for better performance on large datasets.\nwalker = pyg.walk(df)\n","lang":"python","description":"This quickstart demonstrates how to initialize Pygwalker with a pandas DataFrame, launching an interactive UI in your Jupyter Notebook or compatible environment. The `pyg.walk()` function takes a DataFrame and opens a graphical interface for drag-and-drop data exploration. For larger datasets, consider adding `kernel_computation=True` to leverage DuckDB for enhanced performance."},"warnings":[{"fix":"Use `kernel_computation=True` instead for enabling the DuckDB-powered computation engine.","message":"The `use_kernel_calc` parameter in `pyg.walk()` is deprecated.","severity":"deprecated","affected_versions":"<=0.4.x"},{"fix":"Specifically, the `dark` parameter was renamed to `appearance`. Streamlit APIs shifted to a more declarative style. Refer to the official GitHub changelog or documentation for specific migration details related to your usage patterns.","message":"API changes were introduced in version 0.4.8, affecting general and Streamlit APIs.","severity":"breaking","affected_versions":"0.4.8 and later"},{"fix":"Users must manually click the 'Save' button within the Pygwalker UI to persist chart metadata to the specified JSON file or string. An 'autosave' feature is planned for future releases.","message":"When using the `spec` parameter to save chart configurations, changes made in the UI are not automatically saved.","severity":"gotcha","affected_versions":"All versions up to 0.5.0.1"},{"fix":"Obtain a Kanaries token from `kanaries.net` and configure it (e.g., via `pygwalker config --set kanaries_token=YOUR_TOKEN`) to enable these functionalities.","message":"Some cloud-integrated features, such as saving charts to the cloud or using advanced GPT-powered features, require a Kanaries token.","severity":"gotcha","affected_versions":"All versions supporting cloud features"}],"env_vars":null,"last_verified":"2026-04-15T00:00:00.000Z","next_check":"2026-07-14T00:00:00.000Z","problems":[]}