File size: 1,550 Bytes
01b0c57
496bb9a
 
 
 
01b0c57
496bb9a
01b0c57
 
 
 
496bb9a
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
---
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.