Skip to main content
Gitlytics Logo

Gitlytics v0.7.0

GitHub Traffic Analytics, Dynamic Widgets & Automation

License Python PyPI React FastAPI Automation Homepage Blog Live Docs


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


🎨 Interactive Profile Widgets, Cards & Badges

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.

📇 Profile & Repository Cards

Showcase your global activity or project metrics with gorgeous, theme-customizable cards:

👤 User Profile Details Card (Tokyo Night + Coral Title)
Profile Details
📈 Repository Metrics Card (Nord + Dark Steel Slate)
Repository Stats
📊 Language Distribution Chart (Radical + Pink Accents)
Language Distribution
🔥 Contribution Streak Tracker (Solarized Dark + Olive green)
Contribution Streak

🏷️ Multi-Source Tech Badges & Concept Capsules

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)

TypeScript   Python   React   FastAPI   AWS   Docker



🧠 AI/ML & Engineering Concepts (Text-Only Capsules)

Agentic AI   RAG   Embeddings   Vector Search   Fine-Tuning



🔗 Contact & Platform Connectors

GitHub   LinkedIn   Gmail   Portfolio   X


📌 Table of Contents


🔗 The Gitlytics Ecosystem

The full Gitlytics platform consists of modular open-source components:


🤖 Cloud AI Analysis & Automated Insights

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.

📝 Blog & Engineering Space

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.

🔑 Flexible Authentication Modes

Gitlytics v0.7.0 supports 3 authentication modes:

  1. Token Authentication (PAT): Pass your GitHub Personal Access Token (Classic or Fine-Grained) with repo scope to fetch private & public repository metrics.
  2. Demo Mode (Instant Exploration): Explore the web dashboard and CLI immediately using curated sample data without entering any credentials.
  3. Headless TV & Kiosk Mode: Pre-authenticate sessions for office monitors or team dashboards:
    gitlytics dashboard --token "ghp_xxxx" --data-dir "./data"
    

🚨 Defeating GitHub's 14-Day Traffic Limit

⚠️ 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.


🛠️ Installation

Install via PyPI:

# Basic CLI and Python Core Module
pip install gitlytics

# Full installation (includes React Dashboard web engine)
pip install "gitlytics[dashboard]"

⌨️ Core CLI Commands

Gitlytics provides 4 primary command-line utilities:

1️⃣ gitlytics fetch (Live Terminal Data)

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 clones

2️⃣ gitlytics sync (Background Database Cron)

Append 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 * * *"

3️⃣ gitlytics dashboard (React Web UI)

Launch the React + FastAPI web dashboard.

gitlytics dashboard

4️⃣ gitlytics stars (Stargazer History)

Fetch the historical cumulative stargazer growth trajectory for a repository.

gitlytics stars owner/repo --token ghp_your_token

🐍 Native Python API

Import Gitlytics into Python applications to build custom analytics pipelines or host the web engine programmatically.

1️⃣ gitlytics.fetch_traffic()

import gitlytics

# Fetch traffic for all accessible repositories
df = gitlytics.fetch_traffic(
    token="ghp_your_token",
    return_format="dataframe"  # Options: "dataframe", "timeseries", or "summary"
)

2️⃣ gitlytics.sync()

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"
)

3️⃣ gitlytics.serve_dashboard()

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"
)

4️⃣ gitlytics.fetch_star_history()

import gitlytics

points = gitlytics.fetch_star_history(
    owner="ameyachopade",
    repo="gitlytics",
    token="ghp_your_token"
)

📊 CSV Database Schema

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.

🌟 Show Your Support

If you find this project useful, please consider giving it a ⭐ on GitHub!

📄 License

Licensed under the Apache License 2.0.

Metadata

Release files for gitlytics 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gitlytics 0.7.0
File Size Uploaded Provenance Actions
gitlytics-0.7.0.tar.gz 1.1 MB Without provenance Details for gitlytics-0.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gitlytics 0.7.0
File Interpreter ABI Platform Actions
gitlytics-0.7.0-py3-none-any.whl Python 3 none any Details for gitlytics-0.7.0-py3-none-any.whl

Total release size: 2.3 MB

Release files / gitlytics-0.7.0.tar.gz

Download URL gitlytics-0.7.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
3d6c74daba4201409198453721e9a1d1b04488f76ea30ab5549a53311e780cf7
BLAKE2b-256 checksum
How to use checksums
d4db21cbc1f2e475349a7b9625e8460c6350e2245bf07e37d9477674dfa70612
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / gitlytics-0.7.0-py3-none-any.whl

Download URL gitlytics-0.7.0-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
a7b1b4df988cf088d5ca146b831dabcf8198c27d29d578e50c0c5afde050322f
BLAKE2b-256 checksum
How to use checksums
c850c1c658ea1cf90879a9e65f8c5be49e570107fce36642b20ad04652bb3036
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Security for gitlytics 0.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page