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"`.