README.md

metadata

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.