README.md

---
title: Notebook Runner for Book Analytics
emoji: 📚
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 5.23.1
app_file: app.py
pinned: false
---

# Notebook Runner for Book Analytics

This Hugging Face Space runs a Jupyter notebook on two CSV datasets and returns the generated plots, tables, and the executed notebook.

## What this Space does

- Executes `2a_Python_Analysis_Charlotte_Gers.ipynb`
- Uses these datasets:
  - `synthetic_book_reviews.csv`
  - `synthetic_sales_data.csv`
- Displays exported PNG charts in the app
- Lets the user preview exported CSV tables
- Produces a ZIP file containing all execution outputs

## Expected repository structure

Put these files in the Space root:

- `app.py`
- `requirements.txt`
- `README.md`
- `2a_Python_Analysis_Charlotte_Gers.ipynb`
- `synthetic_book_reviews.csv`
- `synthetic_sales_data.csv`

## How to deploy

1. Create a new **Gradio Space** on Hugging Face.
2. Upload all files from this project folder to the Space root.
3. Wait for the Space to build.
4. Open the app and click **Run notebook**.

## Notes

- The app executes the notebook in a temporary working directory so relative CSV paths continue to work.
- The notebook already exports artifacts into `artifacts/py/figures` and `artifacts/py/tables`, and the app reads those outputs automatically.
- Users can either run the bundled notebook and datasets or upload replacements from the interface.

## Recommended repository visibility

Use **private** visibility if the notebook or datasets are not meant to be public.