yanivzalach/icegraph repository overview

IceGraph is a read-only, interactive visualization tool for Apache Iceberg table metadata. Connect it to a Spark Connect backend and explore your table's full physical structure — from root metadata down to individual data and delete files.

⁠Requirements

• A running Spark Connect server (recommended: use a read-only user for extra security).

⁠Quick Start

docker run -e SPARK_REMOTE=sc://<spark-connect-ip>:15002  -p 5050:5050 yanivzalach/icegraph:latest

Then open http://localhost:5050

⁠Features

• 🕰 Time-Travel — view your table's state at any datetime
• 🔴 MOR Awareness — tracks equality and position delete files
• 🌴 Branch Support — visualize all table branches
• 🎯 Lineage Focus — isolate upstream/downstream paths per node
• 📋 Metadata Inspector — file paths, record counts, and stats

⁠Notes

• Read-only — never modifies your table
• Built exclusively for Spark Connect backends
• Supports Iceberg Table Format Version 2

Full documentation and source: github.com/yanivzalach/icegraph⁠