---
title: ESCP Book Analytics Space
emoji: 📚
colorFrom: purple
colorTo: indigo
sdk: gradio
sdk_version: "5.23.3"
app_file: app.py
pinned: false
python_version: "3.10"
---

# ESCP Book Analytics Space

This Hugging Face Space runs the included Jupyter notebook automatically and turns the saved outputs into:

- KPI cards
- Interactive sales charts
- Sentiment charts
- Top-seller analysis
- Table previews
- A simple AI dashboard for natural-language questions

## Files included

- `app.py` — the Gradio application
- `pythonanalysis.ipynb` — your uploaded analysis notebook
- `synthetic_sales_data.csv` — sales dataset
- `synthetic_book_reviews.csv` — reviews dataset
- `style.css` — local styling with no background images
- `requirements.txt` — pinned Python dependencies

## Environment variables

Optional variables for the AI tab:

- `HF_API_KEY`
- `MODEL_NAME`
- `HF_PROVIDER`
- `PAPERMILL_TIMEOUT`
- `AUTO_RUN_ON_LOAD`

## Notes

The app creates notebook outputs inside:

- `artifacts/py/figures`
- `artifacts/py/tables`
- `runs/`

The app also sanitizes the notebook before execution so `!pip install ...` cells are skipped. Dependencies are handled by `requirements.txt`.