Skip to content

Open-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.

Track PyPI download windows

zhifu gao9ec76b59acec
diff --git a/docs/community_growth_20k.md b/docs/community_growth_20k.md
index 4a0a61672..4520d1862 100644
--- a/docs/community_growth_20k.md
+++ b/docs/community_growth_20k.md
@@ -370,7 +370,7 @@ Paste the Markdown output into launch notes, weekly community updates, or releas
- [ ] Pin a GitHub discussion for the release. The release discussion exists at [`modelscope/FunASR#3376`](https://github.com/modelscope/FunASR/discussions/3376), but the GitHub GraphQL API currently exposes `createDiscussion` and `updateDiscussion` but no discussion pin mutation; pin manually in the GitHub Discussions UI or retry if GitHub exposes an API for discussion pinning.
- [ ] Triage all new issues within 48 hours.
- [ ] Convert top 3 support questions into docs.
-- [ ] Track stars, PyPI downloads, issue volume, and docs traffic.
+- [ ] Track stars, PyPI downloads, issue volume, and docs traffic. `collect_growth_metrics.py` now tracks GitHub stars, open issues, and open pull requests for the four core repositories and adds PyPIStats download windows for `funasr` as `downloads_last_7_days` and `downloads_last_30_days` when `pypistats.org` is reachable. The script keeps the patrol usable when PyPIStats is rate-limited by reporting downloads as unavailable instead of failing the run. GitHub/PyPI tracking is now covered; docs traffic remains unavailable until an analytics credential or export is connected.
## Release-note template
diff --git a/scripts/collect_growth_metrics.py b/scripts/collect_growth_metrics.py
index 4e97e12a1..685a7ee64 100755
--- a/scripts/collect_growth_metrics.py
+++ b/scripts/collect_growth_metrics.py
@@ -328,6 +328,37 @@ def fetch_json(url: str, headers: Optional[Dict[str, str]] = None) -> Any:
raise RuntimeError(f"GET {url} failed: {exc.reason}") from exc
+def collect_pypi_download_metrics(package: str) -> Dict[str, Any]:
+ url = f"https://pypistats.org/api/packages/{package}/overall?mirrors=false"
+ try:
+ payload = fetch_json(url, {"User-Agent": "funasr-growth-metrics"})
+ rows = [
+ row
+ for row in payload.get("data", [])
+ if row.get("category") == "without_mirrors"
+ and row.get("date")
+ and isinstance(row.get("downloads"), int)
+ ]
+ rows.sort(key=lambda row: row["date"])
+ if not rows:
+ raise RuntimeError("PyPIStats returned no daily download rows")
+ return {
+ "source": "pypistats.org",
+ "source_url": f"https://pypistats.org/packages/{package}",
+ "latest_date": rows[-1]["date"],
+ "downloads_last_7_days": sum(row["downloads"] for row in rows[-7:]),
+ "downloads_last_30_days": sum(row["downloads"] for row in rows[-30:]),
+ "status": "available",
+ }
+ except Exception as exc:
+ return {
+ "source": "pypistats.org",
+ "source_url": f"https://pypistats.org/packages/{package}",
+ "status": "unavailable",
+ "reason": str(exc),
+ }
+
+
def github_headers() -> Dict[str, str]:
headers = {
"Accept": "application/vnd.github+json",
@@ -710,6 +741,7 @@ def collect_metrics(repo: str, package: str) -> Dict[str, Any]:
"version": pypi.get("info", {}).get("version"),
"summary": pypi.get("info", {}).get("summary"),
"project_url": pypi.get("info", {}).get("project_url"),
+ "downloads": collect_pypi_download_metrics(package),
},
}
return metrics
@@ -752,10 +784,24 @@ def collect_ecosystem_metrics(
"version": pypi.get("info", {}).get("version"),
"summary": pypi.get("info", {}).get("summary"),
"project_url": pypi.get("info", {}).get("project_url"),
+ "downloads": collect_pypi_download_metrics(package),
},
}
+def format_pypi_downloads(pypi: Dict[str, Any]) -> str:
+ downloads = pypi.get("downloads") or {}
+ if downloads.get("status") == "available":
+ return (
+ f"- PyPI downloads: **{downloads.get('downloads_last_7_days', 0):,}** last 7 days; "
+ f"**{downloads.get('downloads_last_30_days', 0):,}** last 30 days "
+ f"(through {downloads.get('latest_date')}, {downloads.get('source_url')})"
+ )
+ if downloads.get("status") == "unavailable":
+ return f"- PyPI downloads: unavailable via {downloads.get('source', 'PyPIStats')} ({downloads.get('reason')})"
+ return "- PyPI downloads: n/a"
+
+
def format_markdown(metrics: Dict[str, Any], star_goal: int) -> str:
github = metrics["github"]
pypi = metrics["pypi"]
@@ -772,6 +818,7 @@ def format_markdown(metrics: Dict[str, Any], star_goal: int) -> str:
if github.get("open_pull_requests") is not None
else "- Open pull requests: n/a",
f"- PyPI package: **{pypi.get('package')} {pypi.get('version')}**",
+ format_pypi_downloads(pypi),
f"- Last GitHub push: `{github.get('pushed_at')}`",
"",
"## Links",
@@ -797,6 +844,7 @@ def format_ecosystem_markdown(metrics: Dict[str, Any]) -> str:
f"- Target date: **{ecosystem['target_date']}** ({ecosystem['days_remaining']:,} days remaining)",
f"- Required daily average: **{ecosystem['required_daily_average']:,}** stars/day",
f"- PyPI package: **{pypi.get('package')} {pypi.get('version')}**",
+ format_pypi_downloads(pypi),
"",
"## Repositories",
"",
diff --git a/tests/test_collect_growth_metrics.py b/tests/test_collect_growth_metrics.py
index a6d74ef21..372fe86a7 100644
--- a/tests/test_collect_growth_metrics.py
+++ b/tests/test_collect_growth_metrics.py
@@ -353,6 +353,51 @@ def test_collect_ecosystem_metrics_sums_repositories_and_target_gap(monkeypatch)
]
+def test_collect_pypi_download_metrics_sums_recent_windows(monkeypatch):
+ module = load_growth_metrics_module()
+
+ def fake_fetch_json(url, headers=None):
+ assert url == "https://pypistats.org/api/packages/funasr/overall?mirrors=false"
+ return {
+ "data": [
+ {
+ "category": "without_mirrors",
+ "date": f"2026-07-{day:02d}",
+ "downloads": day,
+ }
+ for day in range(1, 32)
+ ]
+ }
+
+ monkeypatch.setattr(module, "fetch_json", fake_fetch_json)
+
+ metrics = module.collect_pypi_download_metrics("funasr")
+
+ assert metrics == {
+ "source": "pypistats.org",
+ "source_url": "https://pypistats.org/packages/funasr",
+ "latest_date": "2026-07-31",
+ "downloads_last_7_days": sum(range(25, 32)),
+ "downloads_last_30_days": sum(range(2, 32)),
+ "status": "available",
+ }
+
+
+def test_collect_pypi_download_metrics_reports_unavailable_without_failing(monkeypatch):
+ module = load_growth_metrics_module()
+
+ def fake_fetch_json(url, headers=None):
+ raise RuntimeError("HTTP 429")
+
+ monkeypatch.setattr(module, "fetch_json", fake_fetch_json)
+
+ metrics = module.collect_pypi_download_metrics("funasr")
+
+ assert metrics["status"] == "unavailable"
+ assert metrics["source"] == "pypistats.org"
+ assert "HTTP 429" in metrics["reason"]
+
+
def test_collect_ecosystem_metrics_calculates_daily_target(monkeypatch):
module = load_growth_metrics_module()
@@ -396,6 +441,42 @@ def test_collect_ecosystem_metrics_calculates_daily_target(monkeypatch):
assert metrics["ecosystem"]["required_daily_average"] == 181
+def test_format_ecosystem_markdown_includes_pypi_download_windows():
+ module = load_growth_metrics_module()
+
+ metrics = {
+ "collected_at_utc": "2026-07-23T00:00:00+00:00",
+ "ecosystem": {
+ "repositories": [],
+ "total_stars": 35787,
+ "baseline_stars": 31224,
+ "target_additional_stars": 20000,
+ "added_stars": 4563,
+ "remaining_to_target": 15437,
+ "target_date": "2026-09-30",
+ "days_remaining": 70,
+ "required_daily_average": 221,
+ },
+ "pypi": {
+ "package": "funasr",
+ "version": "1.3.26",
+ "project_url": "https://pypi.org/project/funasr/",
+ "downloads": {
+ "status": "available",
+ "latest_date": "2026-07-22",
+ "downloads_last_7_days": 70123,
+ "downloads_last_30_days": 301234,
+ "source_url": "https://pypistats.org/packages/funasr",
+ },
+ },
+ }
+
+ output = module.format_ecosystem_markdown(metrics)
+
+ assert "- PyPI downloads: **70,123** last 7 days; **301,234** last 30 days" in output
+ assert "through 2026-07-22" in output
+
+
def test_collect_integration_metrics_summarizes_pull_request_checks(monkeypatch):
module = load_growth_metrics_module()
diff --git a/tests/test_growth_plan_doc.py b/tests/test_growth_plan_doc.py
index 18d546e68..69b20aff3 100644
--- a/tests/test_growth_plan_doc.py
+++ b/tests/test_growth_plan_doc.py
@@ -233,3 +233,19 @@ def test_growth_plan_records_homepage_entrypoint_completion():
assert marker in text
assert "[ ] Update homepage hero and docs entry points" not in text
+
+
+def test_growth_plan_records_metrics_tracking_progress():
+ text = PLAN.read_text()
+
+ required_markers = [
+ "[ ] Track stars, PyPI downloads, issue volume, and docs traffic.",
+ "PyPIStats",
+ "`downloads_last_7_days`",
+ "`downloads_last_30_days`",
+ "`collect_growth_metrics.py`",
+ "GitHub stars, open issues, and open pull requests",
+ "docs traffic remains unavailable until an analytics credential or export is connected",
+ ]
+ for marker in required_markers:
+ assert marker in text