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
|