Please consider giving this project a ⭐ if you find it helpful!
Beautiful GitHub traffic analytics for all your repositories — public and private.
Track views, clones, referrers, popular paths, stargazer trajectories, and health metrics indefinitely.
✨ Try the live dashboard at dashboard.gitlytics.dev ✨
📝 Read engineering deep-dives at blog.gitlytics.dev ✨
📚 Read the documentation at docs.gitlytics.dev
Elevate your GitHub profile README and developer portfolios with Gitlytics' native, dynamic widget rendering suite. Serve real-time stats cards, commit-level language breakdowns, repository health scorecards, concept tags, and tech badges.
Showcase your global activity or project metrics with gorgeous, theme-customizable cards:
👤 User Profile Details Card (Tokyo Night + Coral Title)
|
📈 Repository Metrics Card (Nord + Dark Steel Slate)
|
📊 Language Distribution Chart (Radical + Pink Accents)
|
🔥 Contribution Streak Tracker (Solarized Dark + Olive green)
|
Generate beautifully styled capsule badges for your tech stack. Support for 200+ technology logos from official libraries, plus custom text-only capsule badges for concepts without brand icons (e.g. AI/ML methods, SRE, RAG):
🛠️ Languages & Frameworks (Multi-color & Flat Brand Colors)
🧠 AI/ML & Engineering Concepts (Text-Only Capsules)
🔗 Contact & Platform Connectors
- 🔗 The Gitlytics Ecosystem
- 🤖 Cloud AI Analysis & Automated Insights
- 📝 Blog & Engineering Space
- 🔑 Flexible Authentication Modes
- 🚨 Defeating GitHub's 14-Day Traffic Limit
- 🛠️ Installation
- ⌨️ Core CLI Commands
- 🐍 Native Python API
- 📊 CSV Database Schema
- 🌟 Show Your Support
- 📄 License
The full Gitlytics platform consists of modular open-source components:
- 📊 Gitlytics Live Dashboard: Production web interface to visualize repository traffic, trends, and historical charts.
- 📝 Gitlytics Blog: Engineering deep-dives, comparison guides, and open-source analytics tutorials.
- 📚 Gitlytics Metadata Pages & Docs: Technical reference, badge explorer, and CLI documentation.
- ⚙️ Gitlytics Automation: GitHub Action companion tool that fetches and backs up traffic data automatically.
Gitlytics Cloud includes an automated AI intelligence engine powered by LLMs (Groq API) and cloud database synchronization (Supabase):
- Automated AI Repository Health Checks: Analyzes repository traffic trends, CI stability, PR cycle times, and contributor activity to produce automated health scorecards.
- Anomaly & Spike Detection: Identifies traffic surges, viral referrer shifts, and clone spikes, surfacing actionable insights.
- Cloud Persistence & Multi-Repo Aggregation: Synchronizes historical snapshots to cloud storage, enabling seamless multi-repository comparison and organization-wide analytics.
- Weekly Email Digest Reports: Delivers automated weekly summaries (via Resend API) summarizing top referral channels, view growth, and stargazer milestones directly to your inbox.
Explore our official engineering publication at blog.gitlytics.dev:
- Engineering Deep-Dives: Learn how Gitlytics solves GitHub's 14-day traffic retention cap, renders high-performance SVG badges, and handles multi-repository data pipelines.
- Comparison Guides: Detailed breakdowns comparing Gitlytics with native GitHub Insights, Shields.io, and third-party analytics platforms.
- AI Agent Context: The blog provides a dedicated structured text endpoint (
https://blog.gitlytics.dev/llms-full.txt) formatted specifically for consumption by AI agents and LLM tools.
Gitlytics v0.6.0 supports 3 authentication modes:
- Token Authentication (PAT): Pass your GitHub Personal Access Token (Classic or Fine-Grained) with
reposcope to fetch private & public repository metrics. - Demo Mode (Instant Exploration): Explore the web dashboard and CLI immediately using curated sample data without entering any credentials.
- Headless TV & Kiosk Mode: Pre-authenticate sessions for office monitors or team dashboards:
gitlytics dashboard --token "ghp_xxxx" --data-dir "./data"
⚠️ Did you know? GitHub normally only saves your repository traffic data for 14 days. After two weeks, your valuable views and clones data is permanently deleted.
We built a companion automation tool that runs silently every 13 days using GitHub Actions to snapshot and preserve your traffic data.
👉 Set up GitHub Traffic Automation here (Takes under 2 minutes to set up!)
Once your traffic snapshots are saved, Gitlytics automatically merges overlaps to build continuous historical analytics over months or years.
Install via PyPI:
# Basic CLI and Python Core Module
pip install gitlytics
# Full installation (includes React Dashboard web engine)
pip install "gitlytics[dashboard]"Gitlytics provides 4 primary command-line utilities:
Fetch your live 14-day traffic and print ASCII tables directly in your console.
gitlytics fetch --token ghp_your_token_here --print-table
# Fetch specific metrics only (e.g., views and clones)
gitlytics fetch --token ghp_your_token_here --print-table --metrics views clonesAppend traffic snapshots to local CSV databases. Can run as a background cron job:
# Sync once
gitlytics sync --token ghp_your_token --data-dir ./data
# Run as a background cron job (runs daily at 11:00 PM)
gitlytics sync --token ghp_your_token --data-dir ./data --schedule-cron "0 23 * * *"Launch the React + FastAPI web dashboard.
gitlytics dashboardFetch the historical cumulative stargazer growth trajectory for a repository.
gitlytics stars owner/repo --token ghp_your_tokenImport Gitlytics into Python applications to build custom analytics pipelines or host the web engine programmatically.
import gitlytics
# Fetch traffic for all accessible repositories
df = gitlytics.fetch_traffic(
token="ghp_your_token",
return_format="dataframe" # Options: "dataframe", "timeseries", or "summary"
)import gitlytics
# Sync snapshots and export consolidated JSON for the dashboard
gitlytics.sync(
token="ghp_your_token",
data_dir="./data",
export_json="./data/export.json"
)import gitlytics
# Serve the dashboard programmatically on a custom port
gitlytics.serve_dashboard(
host="0.0.0.0",
port=8080,
token="ghp_your_token",
data_dir="./data"
)import gitlytics
points = gitlytics.fetch_star_history(
owner="ameyac11",
repo="gitlytics",
token="ghp_your_token"
)Local CSV databases track up to 23 metrics per snapshot:
| Column | Type | Description |
|---|---|---|
date |
str |
ISO date (YYYY-MM-DD) for this day's traffic snapshot. |
repository |
str |
Full GitHub repository name (owner/repo). |
is_private |
bool |
True if repository is private, False otherwise. |
views |
int |
Total page views on this day. |
unique_visitors |
int |
Unique visitors on this day. |
clones |
int |
Total git clone operations on this day. |
unique_cloners |
int |
Unique clone clients on this day. |
stars |
int |
Current total star count snapshot. |
forks |
int |
Current total fork count snapshot. |
language |
str |
Primary programming language of the repository. |
topics |
str |
JSON array containing repository tags/topics. |
watchers_count |
int |
Total watchers of the repository. |
pushed_at |
str |
Last push ISO timestamp. |
created_at |
str |
Repository creation ISO timestamp. |
open_issues_count |
int |
Total number of open issues. |
top_referrer |
str |
Top external traffic referral source. |
top_referrer_views |
int |
Views sent by the top referrer. |
top_referrer_uniques |
int |
Uniques sent by the top referrer. |
_raw_referrers |
str |
Raw JSON array of all referral sources. |
top_path |
str |
Most visited repository file path. |
top_path_views |
int |
Views for the top path. |
top_path_uniques |
int |
Uniques for the top path. |
_raw_paths |
str |
Raw JSON array of all popular paths. |
If you find this project useful, please consider giving it a ⭐ on GitHub!
Licensed under the Apache License 2.0.