You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Improving getting started with pyiceberg using the new notebook addition #2971
Context
With the recent merger of PR #2528, the repository now supports make notebook and make notebook-infra commands. These provide an instant, containerized environment for users to test PyIceberg with and without a full Spark infrastructure.
Problem
The current "Getting Started" documentation does not yet reflect these new capabilities. New users might still be manually configuring environments or struggling to set up Spark, unaware that a single command can now provision a full lab with PyIceberg, Spark Connect, MinIO, and a REST catalog.
Proposal
We should update the documentation (specifically the README.md and the "Getting Started" site page) to highlight this new workflow.
Suggested Changes:
PyIceberg Quickstart: Add a section explaining how to use make notebook to quickly launch a Jupyter environment for exploring the PyIceberg API.
Full Integration Demo: Add a section explaining make notebook-infra for users who want to test PyIceberg with a local Spark cluster (using Spark Connect) and MinIO.
Reference Example Notebooks: Link to the new notebooks/pyiceberg_example.ipynb and notebooks/spark_integration_example.ipynb as the recommended starting points.
Benefits
Significantly lowers the barrier to entry for new contributors and users.
Standardizes the local development environment.
Showcases the PyIceberg + Spark Connect integration out of the box.
This issue has been automatically marked as stale because it has been open for 180 days with no activity. It will be closed in next 14 days if no further activity occurs. To permanently prevent this issue from being considered stale, add the label 'not-stale', but commenting on the issue is preferred when possible.
Activity
kevinjqliu commentedon Jan 27, 2026
Thanks! These are the notebook 😄
https://github.com/apache/iceberg-python/blob/main/notebooks/pyiceberg_example.ipynb
https://github.com/apache/iceberg-python/blob/main/notebooks/spark_integration_example.ipynb
tusharchou commentedon Jan 27, 2026
Context
With the recent merger of PR #2528, the repository now supports
make notebookandmake notebook-infracommands. These provide an instant, containerized environment for users to test PyIceberg with and without a full Spark infrastructure.Problem
The current "Getting Started" documentation does not yet reflect these new capabilities. New users might still be manually configuring environments or struggling to set up Spark, unaware that a single command can now provision a full lab with PyIceberg, Spark Connect, MinIO, and a REST catalog.
Proposal
We should update the documentation (specifically the
README.mdand the "Getting Started" site page) to highlight this new workflow.Suggested Changes:
make notebookto quickly launch a Jupyter environment for exploring the PyIceberg API.make notebook-infrafor users who want to test PyIceberg with a local Spark cluster (using Spark Connect) and MinIO.notebooks/pyiceberg_example.ipynbandnotebooks/spark_integration_example.ipynbas the recommended starting points.Benefits
github-actions commentedon Jul 27, 2026
This issue has been automatically marked as stale because it has been open for 180 days with no activity. It will be closed in next 14 days if no further activity occurs. To permanently prevent this issue from being considered stale, add the label 'not-stale', but commenting on the issue is preferred when possible.
github-actions commentedon Aug 11, 2026
This issue has been closed because it has not received any activity in the last 14 days since being marked as 'stale'