README.md

metadata

title: GitHub Notebook Fixer
emoji: 🔧
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 6.9.0
app_file: app.py
pinned: false
license: mit
short_description: Fix .ipynb files that show "Invalid Notebook" on GitHub

🔧 GitHub Notebook Fixer

Upload a .ipynb notebook and this Space will:

1. Predict if it will render on GitHub or fail
2. Diagnose every issue (missing widget state, oversized outputs, bad metadata)
3. Return a fixed .ipynb ready to push

Why do notebooks break on GitHub?

The most common cause is Google Colab saving widget metadata without the required state key. GitHub's nbconvert renderer requires metadata.widgets["application/vnd.jupyter.widget-state+json"]["state"] to exist — if it doesn't, you get the dreaded:

Invalid Notebook — the 'state' key is missing from 'metadata.widgets'

Other causes include oversized cell outputs (>500 KB), giant base64 images, and missing kernelspec metadata.

How to use

1. Upload your .ipynb file
2. Click Analyze & Fix
3. Read the diagnosis report
4. Download the fixed notebook
5. Push to GitHub — it will render!

🔒 Privacy & Data

Your files are never stored.

• Your .ipynb file is read in memory only — it never touches a database or persistent storage.
• A short-lived OS temp file is created so you can download the fixed notebook, then it is automatically deleted.
• No personal information, file content, or usage data is logged or shared with third parties.
• Once your session ends, every trace of your file is gone.

Run locally

pip install gradio
python app.py