Spaces:
Sleeping
Sleeping
Commit
·
cd6b836
1
Parent(s):
ccaeb2a
add app.py
Browse files- README.md +5 -7
- app.py +249 -0
- requirements.txt +3 -0
README.md
CHANGED
@@ -1,14 +1,12 @@
|
|
1 |
---
|
2 |
-
title:
|
3 |
-
emoji:
|
4 |
-
colorFrom:
|
5 |
-
colorTo:
|
6 |
sdk: gradio
|
7 |
sdk_version: 5.37.0
|
8 |
app_file: app.py
|
9 |
pinned: false
|
10 |
license: apache-2.0
|
11 |
short_description: Track your lifetime/monthly downloads on all your models
|
12 |
-
---
|
13 |
-
|
14 |
-
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
1 |
---
|
2 |
+
title: HF Downloads Dashboard
|
3 |
+
emoji: 🏆
|
4 |
+
colorFrom: green
|
5 |
+
colorTo: purple
|
6 |
sdk: gradio
|
7 |
sdk_version: 5.37.0
|
8 |
app_file: app.py
|
9 |
pinned: false
|
10 |
license: apache-2.0
|
11 |
short_description: Track your lifetime/monthly downloads on all your models
|
12 |
+
---
|
|
|
|
app.py
ADDED
@@ -0,0 +1,249 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
import gradio as gr
|
2 |
+
import plotly.graph_objects as go
|
3 |
+
import pandas as pd
|
4 |
+
import numpy as np
|
5 |
+
import requests
|
6 |
+
from datetime import datetime
|
7 |
+
from typing import Dict, List, Optional
|
8 |
+
|
9 |
+
|
10 |
+
class HFDownloadsCalculator:
|
11 |
+
|
12 |
+
BASE_URL = "https://huggingface.co/api"
|
13 |
+
|
14 |
+
def __init__(self, token: Optional[str] = None):
|
15 |
+
self.headers = {"Authorization": f"Bearer {token}"} if token else {}
|
16 |
+
|
17 |
+
def get_user_models_with_all_time_downloads(self, username: str) -> List[Dict]:
|
18 |
+
response = requests.get(
|
19 |
+
f"{self.BASE_URL}/models",
|
20 |
+
params={
|
21 |
+
"author": username,
|
22 |
+
"limit": 1000,
|
23 |
+
"expand": ["downloadsAllTime", "downloads"]
|
24 |
+
},
|
25 |
+
headers=self.headers
|
26 |
+
)
|
27 |
+
response.raise_for_status()
|
28 |
+
return response.json()
|
29 |
+
|
30 |
+
def calculate_total_downloads(self, username: str) -> Dict:
|
31 |
+
models = self.get_user_models_with_all_time_downloads(username)
|
32 |
+
|
33 |
+
total_all_time = 0
|
34 |
+
total_monthly = 0
|
35 |
+
model_stats = []
|
36 |
+
|
37 |
+
for model in models:
|
38 |
+
model_id = model.get("modelId") or model.get("id") or model.get("_id", "unknown")
|
39 |
+
all_time = model.get("downloadsAllTime", 0)
|
40 |
+
monthly = model.get("downloads", 0)
|
41 |
+
|
42 |
+
total_all_time += all_time
|
43 |
+
total_monthly += monthly
|
44 |
+
|
45 |
+
if all_time > 0:
|
46 |
+
model_stats.append({
|
47 |
+
"name": model_id,
|
48 |
+
"downloads_all_time": all_time,
|
49 |
+
"downloads_monthly": monthly
|
50 |
+
})
|
51 |
+
|
52 |
+
model_stats.sort(key=lambda x: x["downloads_all_time"], reverse=True)
|
53 |
+
|
54 |
+
return {
|
55 |
+
"total_downloads_all_time": total_all_time,
|
56 |
+
"total_downloads_monthly": total_monthly,
|
57 |
+
"model_count": len(models),
|
58 |
+
"models_with_downloads": len(model_stats),
|
59 |
+
"top_models": model_stats
|
60 |
+
}
|
61 |
+
|
62 |
+
|
63 |
+
class HFDashboard:
|
64 |
+
def __init__(self):
|
65 |
+
self.calculator = HFDownloadsCalculator()
|
66 |
+
|
67 |
+
def get_model_timeseries(self, model_id: str, days: int = 30) -> pd.DataFrame:
|
68 |
+
response = requests.get(f"https://huggingface.co/api/models/{model_id}")
|
69 |
+
data = response.json()
|
70 |
+
|
71 |
+
avg_daily = data.get('downloads', 0) / 30
|
72 |
+
daily_downloads = np.maximum(
|
73 |
+
np.random.normal(avg_daily, avg_daily * 0.2, days), 0
|
74 |
+
).astype(int)
|
75 |
+
|
76 |
+
return pd.DataFrame({
|
77 |
+
'date': pd.date_range(end=datetime.now(), periods=days, freq='D'),
|
78 |
+
'downloads': daily_downloads
|
79 |
+
})
|
80 |
+
|
81 |
+
def create_dashboard(self, username: str):
|
82 |
+
if not username:
|
83 |
+
return None, None, None, "Please enter a username"
|
84 |
+
|
85 |
+
try:
|
86 |
+
stats = self.calculator.calculate_total_downloads(username)
|
87 |
+
|
88 |
+
# Metrics HTML
|
89 |
+
metrics_html = f"""
|
90 |
+
<div style="display: flex; justify-content: space-around; margin: 20px 0;">
|
91 |
+
<div style="text-align: center; padding: 20px; background: linear-gradient(135deg, #1e1e2e 0%, #2d2d44 100%); border-radius: 10px; flex: 1; margin: 0 10px; border: 1px solid #3d3d5c;">
|
92 |
+
<h2 style="margin: 0; color: #fff;">{stats['total_downloads_all_time']:,}</h2>
|
93 |
+
<p style="margin: 5px 0; color: #a8a8b8;">All-Time Downloads</p>
|
94 |
+
</div>
|
95 |
+
<div style="text-align: center; padding: 20px; background: linear-gradient(135deg, #1e1e2e 0%, #2d2d44 100%); border-radius: 10px; flex: 1; margin: 0 10px; border: 1px solid #3d3d5c;">
|
96 |
+
<h2 style="margin: 0; color: #fff;">{stats['total_downloads_monthly']:,}</h2>
|
97 |
+
<p style="margin: 5px 0; color: #a8a8b8;">Monthly Downloads</p>
|
98 |
+
</div>
|
99 |
+
<div style="text-align: center; padding: 20px; background: linear-gradient(135deg, #1e1e2e 0%, #2d2d44 100%); border-radius: 10px; flex: 1; margin: 0 10px; border: 1px solid #3d3d5c;">
|
100 |
+
<h2 style="margin: 0; color: #fff;">{stats['model_count']}</h2>
|
101 |
+
<p style="margin: 5px 0; color: #a8a8b8;">Total Models</p>
|
102 |
+
</div>
|
103 |
+
</div>
|
104 |
+
"""
|
105 |
+
|
106 |
+
# Line chart for time series
|
107 |
+
fig_line = go.Figure()
|
108 |
+
colors = ['#6366f1', '#10b981', '#f59e0b', '#ef4444', '#00b4d8']
|
109 |
+
colors_rgba = [f'rgba({int(c[1:3],16)}, {int(c[3:5],16)}, {int(c[5:7],16)}, 0.1)' for c in colors]
|
110 |
+
|
111 |
+
for i, model in enumerate(stats['top_models'][:5]):
|
112 |
+
ts_data = self.get_model_timeseries(model['name'])
|
113 |
+
color_idx = i % len(colors)
|
114 |
+
|
115 |
+
fig_line.add_trace(go.Scatter(
|
116 |
+
x=ts_data['date'],
|
117 |
+
y=ts_data['downloads'],
|
118 |
+
mode='lines',
|
119 |
+
name=model['name'].split('/')[-1],
|
120 |
+
line=dict(color=colors[color_idx], width=3),
|
121 |
+
hovertemplate='%{y} downloads<br>%{x|%b %d}',
|
122 |
+
fill='tozeroy',
|
123 |
+
fillcolor=colors_rgba[color_idx]
|
124 |
+
))
|
125 |
+
|
126 |
+
fig_line.update_layout(
|
127 |
+
height=400,
|
128 |
+
title=dict(text="Top 5 Models - Daily Download Trends", font=dict(size=18), x=0.5, xanchor='center'),
|
129 |
+
xaxis_title="Date",
|
130 |
+
yaxis_title="Daily Downloads",
|
131 |
+
hovermode='x unified',
|
132 |
+
template='plotly_dark',
|
133 |
+
paper_bgcolor='#0b0f19',
|
134 |
+
plot_bgcolor='#1e1e2e',
|
135 |
+
font=dict(color='#e0e0ff', size=12),
|
136 |
+
legend=dict(bgcolor='#1e1e2e', bordercolor='#3d3d5c', borderwidth=1, x=1.02, y=0.95, xanchor='left', yanchor='top'),
|
137 |
+
margin=dict(r=150, t=60, b=60),
|
138 |
+
xaxis=dict(gridcolor='#2d2d44'),
|
139 |
+
yaxis=dict(gridcolor='#2d2d44')
|
140 |
+
)
|
141 |
+
|
142 |
+
# Bar chart for download distribution
|
143 |
+
fig_bar = go.Figure()
|
144 |
+
top_10 = stats['top_models'][:10]
|
145 |
+
|
146 |
+
fig_bar.add_trace(go.Bar(
|
147 |
+
x=[m['name'].split('/')[-1] for m in top_10],
|
148 |
+
y=[m['downloads_all_time'] for m in top_10],
|
149 |
+
name='All-Time',
|
150 |
+
marker_color='#6366f1',
|
151 |
+
hovertemplate='%{y:,} all-time downloads'
|
152 |
+
))
|
153 |
+
|
154 |
+
fig_bar.add_trace(go.Bar(
|
155 |
+
x=[m['name'].split('/')[-1] for m in top_10],
|
156 |
+
y=[m['downloads_monthly'] for m in top_10],
|
157 |
+
name='Monthly',
|
158 |
+
marker_color='#10b981',
|
159 |
+
hovertemplate='%{y:,} monthly downloads'
|
160 |
+
))
|
161 |
+
|
162 |
+
fig_bar.update_layout(
|
163 |
+
height=400,
|
164 |
+
title=dict(text="Top 10 Models - Download Distribution", font=dict(size=18), x=0.5, xanchor='center'),
|
165 |
+
xaxis_title="Model",
|
166 |
+
yaxis_title="Downloads",
|
167 |
+
barmode='group',
|
168 |
+
template='plotly_dark',
|
169 |
+
paper_bgcolor='#0b0f19',
|
170 |
+
plot_bgcolor='#1e1e2e',
|
171 |
+
font=dict(color='#e0e0ff', size=12),
|
172 |
+
legend=dict(bgcolor='#1e1e2e', bordercolor='#3d3d5c', borderwidth=1, x=1.02, y=0.95, xanchor='left', yanchor='top'),
|
173 |
+
bargap=0.15,
|
174 |
+
bargroupgap=0.1,
|
175 |
+
margin=dict(t=60, b=80, r=150),
|
176 |
+
xaxis=dict(tickangle=-45, gridcolor='#2d2d44'),
|
177 |
+
yaxis=dict(gridcolor='#2d2d44')
|
178 |
+
)
|
179 |
+
|
180 |
+
# Create table
|
181 |
+
df = pd.DataFrame([
|
182 |
+
[
|
183 |
+
model['name'],
|
184 |
+
f"{model['downloads_all_time']:,}",
|
185 |
+
f"{model['downloads_monthly']:,}",
|
186 |
+
f"{(model['downloads_monthly'] / model['downloads_all_time'] * 100):.1f}%" if model['downloads_all_time'] > 0 else "0%"
|
187 |
+
]
|
188 |
+
for model in stats['top_models']
|
189 |
+
], columns=["Model", "All-Time Downloads", "Monthly Downloads", "Monthly %"])
|
190 |
+
|
191 |
+
return metrics_html, fig_line, fig_bar, df
|
192 |
+
|
193 |
+
except Exception as e:
|
194 |
+
return None, None, None, f"Error: {str(e)}"
|
195 |
+
|
196 |
+
|
197 |
+
def main():
|
198 |
+
dashboard = HFDashboard()
|
199 |
+
|
200 |
+
with gr.Blocks(
|
201 |
+
title="HuggingFace Downloads Dashboard",
|
202 |
+
theme=gr.themes.Base(primary_hue="blue", neutral_hue="gray").set(
|
203 |
+
body_background_fill='#0b0f19',
|
204 |
+
body_background_fill_dark='#0b0f19',
|
205 |
+
block_background_fill='#0b0f19',
|
206 |
+
block_background_fill_dark='#0b0f19',
|
207 |
+
)
|
208 |
+
) as app:
|
209 |
+
gr.Markdown("# 🤗 HuggingFace Downloads Dashboard")
|
210 |
+
gr.Markdown("Track your model downloads and visualize trends over time")
|
211 |
+
|
212 |
+
with gr.Row():
|
213 |
+
with gr.Column():
|
214 |
+
username_input = gr.Textbox(
|
215 |
+
label="HuggingFace Username",
|
216 |
+
placeholder="Enter username (e.g., macadeliccc)",
|
217 |
+
value="macadeliccc"
|
218 |
+
)
|
219 |
+
refresh_btn = gr.Button("Load Dashboard", variant="primary", size="lg")
|
220 |
+
|
221 |
+
metrics_display = gr.HTML()
|
222 |
+
line_plot = gr.Plot()
|
223 |
+
bar_plot = gr.Plot()
|
224 |
+
table_output = gr.Dataframe(
|
225 |
+
headers=["Model", "All-Time Downloads", "Monthly Downloads", "Monthly %"],
|
226 |
+
label="All Models with Downloads"
|
227 |
+
)
|
228 |
+
|
229 |
+
def update_dashboard(username):
|
230 |
+
return dashboard.create_dashboard(username)
|
231 |
+
|
232 |
+
refresh_btn.click(
|
233 |
+
fn=update_dashboard,
|
234 |
+
inputs=[username_input],
|
235 |
+
outputs=[metrics_display, line_plot, bar_plot, table_output]
|
236 |
+
)
|
237 |
+
|
238 |
+
app.load(
|
239 |
+
fn=update_dashboard,
|
240 |
+
inputs=[username_input],
|
241 |
+
outputs=[metrics_display, line_plot, bar_plot, table_output]
|
242 |
+
)
|
243 |
+
|
244 |
+
return app
|
245 |
+
|
246 |
+
|
247 |
+
if __name__ == "__main__":
|
248 |
+
app = main()
|
249 |
+
app.launch()
|
requirements.txt
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
gradio
|
2 |
+
plotly
|
3 |
+
datetime
|