lukiod commited on
Commit
1ef2c96
ยท
1 Parent(s): 5bfe767
Files changed (1) hide show
  1. README.md +8 -133
README.md CHANGED
@@ -1,133 +1,8 @@
1
- # ๐Ÿ‡ฎ๐Ÿ‡ณ Decode India: Smart AI-Enhanced Dashboard for Growth Metrics
2
-
3
- A powerful interactive dashboard that visualizes and analyzes growth metrics for 35 major Indian cities using AI, time series forecasting, and cluster-based insights.
4
-
5
- ## ๐Ÿš€ Live Demo
6
-
7
- **๐ŸŒ View the live dashboard**: [Hugging Face Spaces](https://huggingface.co/spaces/your-username/decode-india-dashboard)
8
-
9
- ---
10
-
11
- ## ๐Ÿš€ Features
12
-
13
- - ๐Ÿ“Š **Compare Development Metrics**: Visual comparisons between cities on metrics like health, education, infrastructure, etc.
14
- - ๐Ÿ” **Time Series Forecasting**: Uses ARIMA models to predict future values for selected indicators.
15
- - ๐ŸŒ **Radar Chart Visualization**: View cities' SDG performance across multiple indicators.
16
- - ๐Ÿง  **AI-Powered Insights**: Automatically highlights strongest and weakest areas for each city.
17
- - ๐ŸŒ **Twin City Matching**: Suggests cities with similar developmental patterns.
18
- - ๐ŸŽฏ **Clustering**: KMeans-based segmentation to group cities with similar development profiles.
19
- - ๐Ÿงฎ **Correlation Analysis**: Examine relationships between key indicators.
20
-
21
- ---
22
-
23
- ## ๐Ÿ“ Project Structure
24
- ```
25
- Decode-India/
26
- โ”‚
27
- โ”œโ”€โ”€ app.py # Main Dash application
28
- โ”œโ”€โ”€ data/
29
- โ”‚ โ”œโ”€โ”€ india_growth_metrics.csv # City-wide metrics data
30
- โ”‚ โ””โ”€โ”€ timeseries.csv # Year-wise data (2015โ€“2023) for forecasting
31
- โ”œโ”€โ”€ requirements.txt # Python dependencies
32
- โ””โ”€โ”€ README.md # Instructions and documentation
33
- ```
34
-
35
- ---
36
-
37
- ## ๐ŸŒŸ Deploy on Hugging Face Spaces (Recommended)
38
-
39
- ### Step 1: Create Hugging Face Account
40
- 1. Go to [huggingface.co](https://huggingface.co) and sign up
41
- 2. Verify your email address
42
-
43
- ### Step 2: Create a New Space
44
- 1. Click on your profile โ†’ "New Space"
45
- 2. Choose settings:
46
- - **Owner**: Your username
47
- - **Space name**: `decode-india-dashboard`
48
- - **Space SDK**: **Gradio** (we'll use this for Dash)
49
- - **License**: MIT
50
- - **Visibility**: Public
51
-
52
- ### Step 3: Upload Your Code
53
- 1. Clone the space repository:
54
- ```bash
55
- git clone https://huggingface.co/spaces/your-username/decode-india-dashboard
56
- cd decode-india-dashboard
57
- ```
58
-
59
- 2. Copy your files:
60
- ```bash
61
- # Copy all your project files
62
- cp -r /path/to/your/project/* .
63
- ```
64
-
65
- 3. Push to Hugging Face:
66
- ```bash
67
- git add .
68
- git commit -m "Initial deployment"
69
- git push
70
- ```
71
-
72
- ### Step 4: Your App is Live!
73
- Your dashboard will be available at:
74
- `https://huggingface.co/spaces/your-username/decode-india-dashboard`
75
-
76
- ---
77
-
78
- ## โš™๏ธ How to Run the Dashboard Locally
79
-
80
- ### 1๏ธโƒฃ Clone the Repository
81
-
82
- ```bash
83
- git clone https://github.com/your-username/Decode-India.git
84
- cd Decode-India
85
- ```
86
- ### Create & Activate a Virtual Environment
87
- python -m venv .venv
88
- # Activate the environment:
89
- # On Windows
90
- ```bash
91
- .venv\Scripts\activate
92
- ```
93
- # On macOS/Linux
94
- ```bash
95
- source .venv/bin/activate
96
- ```
97
- ### Install Required Dependencies
98
- ```bash
99
- pip install -r requirements.txt
100
- ```
101
- Or install individually:
102
- ```bash
103
- pip install dash pandas plotly numpy scikit-learn statsmodels
104
- ```
105
- ### Add the Data Files
106
- Place the following files in the data/ folder:
107
-
108
- india_growth_metrics.csv โ€“ Contains city-wise growth indicators.
109
-
110
- timeseries.csv โ€“ Contains yearly data for each city for time series analysis (2015โ€“2023)
111
-
112
- ### Run the Application
113
- ```bash
114
- python app.py
115
- ```
116
-
117
- ### View in Browser
118
- Visit:
119
-
120
- ```bash
121
- http://127.0.0.1:8050/
122
- ```
123
-
124
- ---
125
-
126
- ## ๐ŸŽฏ Alternative Deployment Options
127
-
128
- See [DEPLOYMENT.md](DEPLOYMENT.md) for other deployment options including:
129
- - Railway
130
- - Render
131
- - Heroku
132
- - Docker
133
- - VPS/Cloud servers
 
1
+ title: codeclash
2
+ emoji: ๐Ÿฆ€
3
+ colorFrom: pink
4
+ colorTo: green
5
+ sdk: gradio
6
+ sdk_version: 5.27.1
7
+ app_file: app.py
8
+ pinned: false