File size: 2,017 Bytes
4be3b7a
 
 
 
 
 
 
 
 
9801c69
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
---

title: Srivari Seva
emoji: ๐Ÿ›•
colorFrom: yellow
colorTo: red
sdk: docker
pinned: false
---


# ๐Ÿ›• Tirumala Darshan Prediction

A web application that predicts the **daily pilgrim count** at Tirumala Sri Venkateswara Swamy Temple.

Pick a date โ†’ see how many pilgrims are expected โ†’ plan your trip accordingly.

---

## ๐Ÿš€ How to Run

```bash

# Activate the environment

.venv_dl\Scripts\activate



# Launch the website

streamlit run app/dashboard.py

```

Open **http://localhost:8501** โ†’ pick a date โ†’ get the prediction.

---

## โœจ Features

- ๐Ÿ“… **Date Picker** โ€” select any date from 2023 to 90 days ahead
- ๐Ÿ”ฎ **Pilgrim Prediction** โ€” AI-powered crowd forecast
- ๐Ÿ“Š **Past Dates** โ€” shows both actual count AND what was predicted (accuracy check)
- ๐Ÿšฆ **Crowd Level** โ€” Low / Moderate / High / Very High
- ๐Ÿ“ˆ **7-Day Trend** โ€” visual bar chart of the upcoming week
- ๐Ÿ“‰ **Recent Footfall** โ€” last 60 days of actual pilgrim data
- ๐Ÿ”„ **Auto-Updates** โ€” data refreshes automatically from official TTD sources

---

## ๐Ÿ“ Project Structure

```

tirumala/

โ”œโ”€โ”€ app/

โ”‚   โ”œโ”€โ”€ config.py        # Configuration

โ”‚   โ”œโ”€โ”€ features.py      # Feature engineering

โ”‚   โ”œโ”€โ”€ scraper.py       # Data scraper (news.tirumala.org)

โ”‚   โ”œโ”€โ”€ trainer.py       # Model training

โ”‚   โ”œโ”€โ”€ predictor.py     # Prediction engine

โ”‚   โ”œโ”€โ”€ dashboard.py     # Main website (Streamlit)

โ”‚   โ”œโ”€โ”€ server.py        # REST API (optional)

โ”‚   โ””โ”€โ”€ scheduler.py     # Pipeline orchestrator

โ”œโ”€โ”€ artefacts/           # Saved models & scalers (auto-created)

โ”œโ”€โ”€ tirumala_darshan_data_clean.csv

โ”œโ”€โ”€ requirements.txt

โ””โ”€โ”€ .gitignore

```

---

## ๐Ÿ“Œ Data Source

All pilgrim data is sourced from [news.tirumala.org](https://news.tirumala.org/category/darshan/) โ€” the official TTD news portal.

---

**เฅ เคจเคฎเฅ‹ เคตเฅ‡เค‚เค•เคŸเฅ‡เคถเคพเคฏ ๐Ÿ™**