Built something? We create video reels & spotlights for GitHub projects.Promote your project →
Home / Methodology
MATHEMATICAL MODEL

Ranking Methodology & Star Velocity Telemetry

How GitHubRepo measures developer momentum, dampens historical vanity bias, and surfaces breakout open-source projects using mathematical velocity equations.

The Core Velocity Formula:

Momentum Score = (Stars Gained Today)² / ln(Total Stars + 10)

1. The Problem with Raw Star Counts

On GitHub, the total number of stars a repository has accumulated is the most widely cited metric of popularity. However, as an indicator of current relevance and developer adoption, total star counts are deeply flawed:

2. Deconstructing the Momentum Velocity Equation

To solve this, GitHubRepo developed the Star Momentum Velocity Score. The formula balances instantaneous acceleration against logarithmic baseline dampening:

Component Breakdown:

  • (Stars Gained Today)²: Squaring the daily star increment exponentially amplifies genuine breakout momentum. A project gaining 80 stars in a single day receives a score proportional to 6,400, whereas a project gaining 5 stars receives 25. This ensures breakthrough software leaps to the top of daily trending feeds.
  • ln(Total Stars + 10): The natural logarithm of the total star count provides gentle, proportional dampening. It ensures that established giants with 150,000 stars cannot monopolize the top ranks with minor routine fluctuations, while still acknowledging the credibility of established codebases.
  • Constant (+ 10): Adding 10 prevents division by zero or negative denominators for newly minted repositories with few stars.

3. Snapshot Cadence & Moving Windows

Our ingestion engine takes structured snapshots at consistent intervals to compute reliable velocity deltas:

Timeframe Baseline Comparison Primary Telemetry Utility
Today (24h) Delta from midnight UTC snapshot Identifies viral breakthroughs and immediate developer surges.
This Week (7d) Delta over a 7-day rolling baseline Filters out short-lived 24h spikes; highlights sustained weekly interest.
This Month (30d) Delta over a 30-day rolling baseline Demonstrates steady engineering adoption and sustained library migration.
Quarterly (90d) Delta over a 90-day rolling baseline Used in deep-dive dossiers to compute annualized growth trajectories.

4. Repository Qualification Heuristics

Not every public repository on GitHub qualifies for our ranked algorithmic discovery feeds. To ensure our users find production-grade, secure software, repositories must meet rigorous qualification standards:

  1. Identifiable Open-Source License: The repository must contain a recognized SPDX open-source license (such as MIT, Apache-2.0, GPL-3.0, BSD-3-Clause, MPL-2.0, or AGPL). Repositories without explicit licenses default to "All Rights Reserved" copyright and are excluded from ranked discovery.
  2. Original Work (Non-Forks): Unmodified forks or repository mirrors are filtered out to prevent duplicate noise and attribute credit to original creators.
  3. Substantive Documentation: The repository must feature an informative description and an instructive README file explaining its installation, architecture, and purpose.
  4. Commit Activity: The repository must exhibit recent code pushes or commit telemetry within our active tracking window.

5. Anti-Gaming & Artificial Spike Filtering

As GitHub star metrics have become influential in open-source credibility, star manipulation and botting services have proliferated. GitHubRepo implements multi-stage anomaly detection:

6. Taxonomy & Category Classification

Repositories are organized into domains (such as AI Agents, DevTools, SaaS Alternatives, Database Engines, Web Frameworks, and Cloud Infrastructure) through a hybrid pipeline combining GitHub topic tags, package manifest detection, and natural language analysis.

7. Corrections & Maintainer Verification

We believe in complete transparency. If you maintain an open-source project and notice an outdated license, inaccurate category classification, or incorrect description, you can request an immediate re-sync via our contact hub or claim your official maintainer verification badge.

From our network
FOR MAINTAINERS

Built something? Put it in front of millions of developers.

We make a short reel about your project and post it across YouTube, Instagram, Threads, and X. Send a link, we do the rest.

SPONSORED Sponsored Partner