DEPLOY.md

Deployment Guide

Web UI upload path

1. Go to Hugging Face and create a new Gradio Space.
2. Download and unzip this package.
3. Upload all files from the folder to the Space root.
4. Wait for the build to install dependencies from requirements.txt.
5. Open the Space. On first load, the notebook runs automatically.
6. Use Notebook Runner if you want to re-run the notebook manually.

Expected runtime behavior

• The app reads synthetic_sales_data.csv and synthetic_book_reviews.csv.
• It runs pythonanalysis.ipynb with Papermill.
• Saved figures appear in the gallery.
• Saved CSV and JSON outputs appear in the table preview and KPI cards.

Common fixes

• If build fails, confirm the Space SDK is Gradio.
• If notebook execution fails, check the Execution Log tab output.
• If the AI tab does not use an LLM, set HF_API_KEY in Space variables.

Build error fix applied

The previous package used python_version: 3.10 without quotes in README.md. In YAML, that can be interpreted as 3.1, which makes Hugging Face try to pull python:3.1. This package fixes it by using python_version: "3.10".