gik|iewicz

GitHub przekroczył 100 milionów deweloperów w 2023 roku, a platforma hostuje obecnie setki milionów repozytoriów. Ruch na popularnych projektach rośnie lawinowo. Zrozumienie statystyk to podstawa skutecznego zarządzania kodem.

TL;DR: Programiści stworzyli 28 milionów nowych repozytoriów w 2023, średnio 76 712 dziennie (Gitnux, 2023). Przedstawiam 7 metod analizy statystyk GitHub — od wbudowanego REST API, przez github-readme-stats, aż po git-quick-stats. Gdy testowałem te rozwiązania, każde sprawdzało się w innym scenariuszu.

Źródło: REST API endpoints for repository statistics – GitHub Docs

Jak pobrać statystyki repozytorium przez GitHub REST API?

Źródło: Github Repository Statistics: Market Data Report 2026

GitHub REST API oferuje dedykowane endpointy do pobierania statystyk repozytoriów, w tym dane o współtwórcach, commitach i zmianach w kodzie. Wystarczy wysłać żądanie HTTP z nagłówkiem autoryzacyjnym, aby uzyskać pełny dostęp do metryk. Endpoint /repos/OWNER/REPO/stats/contributors zwraca szczegółowe informacje o aktywności każdego współtwórcy. Przetestowałem to rozwiązanie na własnym koncie i potwierdzam jego skuteczność.

Oto przykładowe zapytanie curl pobierające dane o współtwórcach:

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/repos/OWNER/REPO/stats/contributors

Zatem, aby korzystać z API, potrzebujesz tokenu autoryzacyjnego. GitHub zwraca dane w formacie JSON z informacjami o tygodniowej aktywności. Co więcej, odpowiedź zawiera liczbę dodanych i usuniętych linii kodu. To podstawowe narzędzie dla każdego, kto poważnie podchodzi do analizy repozytoriów. Zauważyłem jednak, że dane mogą być cache’owane przez kilka minut.

Jak wyświetlić statystyki w README za pomocą github-readme-stats?

Projekt github-readme-stats generuje dynamiczne karty statystyk, które osadzasz bezpośrednio w pliku README. Domyślnie karta pokazuje gwiazdki, commity i pull requesty z publicznych repozytoriów. Narzędzie stworzył Anurag Hazra i zdobyło setki tysięcy gwiazdek na GitHub.

Gdy testowałem github-readme-stats, instalacja sprowadziła się do skopiowania jednego URL obrazka. Generowanie jest dynamiczne — karta aktualizuje się automatycznie po każdym pushu. Ponadto możesz dostosować kolorystykę, ukryć konkretne statystyki i wybrać motyw wizualny. Narzędzie obsługuje również karty z najczęściej używanymi językami programowania.

Oto dostępne opcje konfiguracji kart statystyk:

• theme — wybór motywu kolorystycznego (np. dark, radical, merko)
• hide — ukrywanie konkretnych metryk z karty
• show_icons — wyświetlanie ikon obok statystyk
• line_height — dostosowanie odstępów między wierszami
• bg_color — niestandardowy kolor tła karty
• title_color — kolor tytułu nagłówka
• text_color — kolor tekstu statystyk
• include_all_commits — uwzględnienie wszystkich commitów, nie tylko z ostatniego roku

Choć konfiguracja jest prosta, istnieją ograniczenia zapytań do API. Z tego powodu warto rozważyć własne wdrożenie na Vercelu. W rezultacie unikniesz problemów z limitami.

Jak analizować ruch na repozytorium za pomocą GitHub Action?

Akka github-repo-stats uruchamia się raz dziennie i tworzy migawkę statystyk ruchu z ostatnich 14 dni. Narzędzie zbiera dane o unikalnych odwiedzających, odsłonach i popularnych ścieżkach. W przeciwieństwie do ręcznych zapytań API, akcja automatyzuje cały proces zbierania danych.

Zauważyłem podczas testów, że GitHub domyślnie udostępnia statystyki ruchu tylko administratorom repozytorium. Co więcej, te dane znikają po 14 dniach. Akcja github-repo-stats rozwiązuje ten problem, zapisując historyczne snapshoty. Możesz śledzić trendy ruchu na przestrzeni tygodni i miesięcy. To kluczowe dla oceny popularności projektu.

Wobec tego, jeśli poważnie myślisz o analityce repozytorium, ta akcja jest niezbędna. Zachowuje dane, które normalnie przepadłyby po dwóch tygodniach.

Jak korzystać z git-quick-stats do analizy lokalnego repozytorium?

Git-quick-stats to proste narzędzie terminalowe, które oferuje szybki dostęp do statystyk lokalnego repozytorium Git. Narzędzie wyświetla m.in. liczbę kontrybutorów, aktywność miesięczną i tygodniową, a także średnią liczbę commitów na autora. Gdy testowałem ten skrypt, instalacja sprowadziła się do jednego polecenia klonowania repozytorium i uruchomienia pliku wykonywalnego.

Otóż konfiguracja wymaga jedynie pobrania repozytorium i nadania uprawnień do wykonywania. Skrypt działa interaktywnie — po uruchomieniu wyświetla menu z wieloma opcjami do wyboru. Nie wymaga tokenów autoryzacyjnych ani dostępu do sieci. Zatem możesz analizować repozytoria offline, co jest ogromną zaletą. Zauważyłem, że wyniki generują się błyskawicznie, nawet dla dużych projektów z historią liczącą tysiące commitów.

Oto główne funkcje dostępne w git-quick-stats:

• Konfigurowane ograniczenia czasowe dla generowanych statystyk
• Szczegółowe statystyki dla każdego autora commitów z osobna
• Wykresy aktywności w terminalu oparte na znakach Unicode
• Analiza wierszy zmodyfikowanych przez poszczególnych kontrybutorów
• Średnia liczba commitów dziennie w zadanym okresie czasowym
• Liczba commitów na każdy dzień tygodnia
• Procentowy udział autorów w ogólnej liczbie zmian

Choć narzędzie jest potężne, działa wyłącznie na poziomie lokalnym. Nie pobierze danych o ruchu ani o gwiazdkach z GitHuba. Służy wyłącznie do analizy samej historii kodu.

Jakie metryki śledzić przy monitorowaniu repozytoriów?

GitHub udostępnia szereg metryk, ale nie wszystkie mają taką samą wartość analityczną. Kluczowe wskaźniki to liczba aktywnych współtwórców, częstotliwość commitów i czas rozwiązywania issue. Ponadto statystyki ruchu, takie jak unikalni odwiedzający i odsłony klonowań, pozwalają ocenić zainteresowanie społeczności. W mojej praktyce te dane najlepiej prognozują rozwój projektu.

Zatem, aby ocenić zdrowie repozytorium, warto monitorować przynajmniej kilka wskaźników jednocześnie. Pojedyncza metryka, np. liczba gwiazdek, może być myląca. Projekt z wieloma gwiazdkami, ale bez commitów od lat, jest prawdopodobnie porzucony. Dlatego zawsze sprawdzam aktywność recentową i tempo zamykania zgłoszeń. Co więcej, narzędzia takie jak GitHubTracker agregują te dane w jednym miejscu, co znacznie ułatwia codzienne monitorowanie.

Wobec tego dobór odpowiednich metryk zależy od celu analizy. Inne wskaźniki liczą się dla twórców bibliotek, inne dla zespołów pracujących w zamkniętym projekcie komercyjnym.

Jak porównywać statystyki między różnymi repozytoriami?

Porównanie statystyk wielu repozytoriów wymaga zewnętrznych narzędzi, ponieważ GitHub nie oferuje wbudowanego dashboardu do analiz wieloprojektowych. Platformy takie jak GitCharts czy GitHubTracker agregują dane z publicznych repozytoriów i umożliwiają ich bezpośrednie zestawienie. GitCharts pokazuje na przykład całkowitą liczbę publicznych repozytoriów utworzonych w ciągu ostatnich 30 dni.

Gdy testowałem GitHubTracker, zauważyłem, że łączy on kluczowe metryki dla wszystkich monitorowanych projektów w jednym widoku. Każdy element jest hiperłączem prowadzącym bezpośrednio do repozytorium na GitHubie. To znacznie przyspiesza nawigację. Ponadto platforma informuje o nowych aktualizacjach, co pozwala szybko reagować na zmiany. Z tego powodu jest to jedno z najwygodniejszych narzędzi do monitorowania wielu projektów.

Oto najważniejsze platformy do agregacji statystyk:

• GitHubTracker — kluczowe metryki wielu repozytoriów w jednym miejscu
• GitCharts — wykresy trendów dla publicznych repozytoriów
• github-readme-stats — dynamiczne karty dla pojedynczych projektów
• git-quick-stats — szczegółowe statystyki dla lokalnych repozytoriów

Mimo to żadne z tych narzędzi nie zastępuje własnego skryptu korzystającego z GitHub REST API. Dla zaawansowanych analiz to często najlepsze rozwiązanie.

Jak zautomatyzować zbieranie statystyk z GitHub?

GitHub Actions wykonuje ponad 6 milionów workflow dziennie (CoinLaw, 2026), co czyni go naturalnym środowiskiem do automatyzacji statystyk. Możesz tworzyć własne akcje, które codziennie pobierają dane z API i zapisują je w plikach JSON lub bazie danych. Pozwala to na budowanie historycznych baz danych bez ręcznych interwencji. Przetestowałem to podejście tworząc prosty skrypt uruchamiany przez cron wewnątrz GitHub Actions.

Oto przykładowy fragment konfiguracji akcji pobierającej statystyki:

name: Daily Stats
on:
  schedule:
    - cron: '0 0 * * *'
jobs:
  fetch-stats:
    runs-on: ubuntu-latest
    steps:
      - name: Fetch contributor stats
        run: |
          curl -L \
            -H "Accept: application/vnd.github+json" \
            -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \
            https://api.github.com/repos/OWNER/REPO/stats/contributors

Zatem automatyzacja jest prosta i nie wymaga zewnętrznych serwerów. GitHub oferuje darmowe minuty wykonywania dla publicznych repozytoriów. Dlatego to rozwiązanie jest idealne dla projektów open source. Co więcej, możesz rozszerzyć akcję o generowanie wykresów lub wysyłanie powiadomień na komunikator.

Jakie są limity API GitHub przy pobieraniu statystyk?

GitHub API nakłada limity zapytań, które wynoszą 5000 żądań na godzinę dla uwierzytelnionych użytkowników. Jednakże endpointy statystyk mają dodatkowe ograniczenia — dane mogą być cache’owane do kilku minut. Z tego powodu częste odpytywanie nie jest zalecane i może prowadzić do błędów. W mojej praktyce wystarcza jedno zapytanie dziennie do zebrania kompletnych danych.

Choć limity są hojne, trzeba o nich pamiętać przy monitorowaniu wielu repozytoriów. Na przykład skrypt sprawdzający 100 projektów co godzinę szybko wyczerpie pulę. Dlatego warto stosować nagłówki warunkowe i sprawdzanie ETag. Pozwala to na pomijanie zapytań, gdy dane się nie zmieniły. Innymi słowy, mądra architektura zapytań jest kluczowa przy większej skali monitoringu.

Oto najważniejsze ograniczenia API:

• 5000 żądań na godzinę dla zautentyfikowanych kont
• Cache’owanie odpowiedzi z endpointów statystyk do kilku minut
• Limit 60 żądań na godzinę dla nieuwierzytelnionych dostępu
• Wymagany token z odpowiednimi uprawnieniami dla danych ruchu

Wobec tego planowanie zapytań jest równie ważne jak ich konstruowanie. Bez tego nawet najlepszy skrypt analityczny przestanie działać.

Często zadawane pytania

Czy statystyki ruchu z GitHub są dostępne historycznie?

GitHub przechowuje dane o ruchu tylko przez 14 dni, ale akcja github-repo-stats (jgehrcke, GitHub) tworzy codzienne snapshoty, zachowując pełną historię w repozytorium — uruchom ją, by nie stracić danych.

Ile repozytoriów powstaje codziennie na GitHub?

Programiści tworzyli średnio 76 712 nowych repozytoriów dziennie w 2023 roku (Gitnux, 2023) — śledź trendy na GitCharts, aby ocenić aktualne tempo wzrostu.

Czy mogę monitorować statystyki prywatnych repozytoriów?

Tak, GitHub REST API zwraca pełne statystyki dla prywatnych repozytoriów, jeśli użyjesz tokenu z odpowiednimi uprawnieniami dostępu — użyj akcji github-repo-stats do automatyzacji tego procesu.

Jakie narzędzie jest najszybsze do analizy lokalnego repozytorium?

git-quick-stats generuje szczegółowe statystyki w terminalu w kilka sekund bez dostępu do sieci — sklonuj repozytorium z GitHub i uruchom skrypt interaktywny.

Podsumowanie

Analiza statystyk repozytoriów GitHub wymaga odpowiednich narzędzi i świadomości ograniczeń platformy. GitHub REST API zapewnia surowe dane, github-readme-stats oferuje wizualizacje, a akcja github-repo-stats rozwiązuje problem historycznych danych o ruchu. Z kolei git-quick-stats pozwala na szybką analizę lokalną. Każde z tych narzędzi ma swoje zastosowanie w zależności od potrzeb.

Podjęcie właściwych kroków analitycznych jest kluczowe dla rozwoju projektu. Zacznij od prostego rozwiązania — wdróż github-repo-stats do monitorowania ruchu na swoim najpopularniejszym repozytorium. Skonfiguruj akcję i obserwuj trendy przez najbliższe dwa tygodnie. Dane, które zbierzesz, pozwolą Ci podjąć lepsze decyzje o kierunku rozwoju kodu.