Skip to main content
Gitlytics Logo

Gitlytics

Next-Gen GitHub Traffic Intelligence, Dynamic SVG Widgets & Automation

PyPI version Python License FastAPI React Live Dashboard Documentation


The complete developer analytics suite for GitHub.
Bypass GitHub's 14-day traffic cliff, track stargazer trajectories, and launch a local or self-hosted analytics dashboard in seconds.

What ships in the pip install gitlytics wheel: the CLI, the Python SDK, and the local/self-hosted React dashboard. The SVG profile cards and tech-badge renderer is a separate hosted service at api.gitlytics.dev - the package does not contain a card generator. See Ecosystem & Links.

Explore Live Dashboard • Read the Docs • Engineering Blog • GitHub Action



⚡ Highlights at a Glance

Feature Description
🚨 14-Day Limit Defeated Automatically snapshot & merge repository views, clones, referrers, and paths indefinitely.
📈 Stargazer Trajectories Real-time cumulative star growth tracking and milestone timeline projections.
🤖 AI Health Scorecards Cloud AI diagnostics analyzing commit velocity, issue health, PR turnaround, and traffic surges.
💻 CLI, Python SDK & Web UI Use it as a terminal command, import it into Python pipelines, or self-host the full React studio.
🎨 Hosted SVG Cards & Logos The hosted service at api.gitlytics.dev renders 31 profile-card slugs in 33 high-contrast themes, plus 181 tech-logo capsules. Not part of the pip package.

🎨 Hosted Profile Cards & Widgets

Hosted service, not the pip package. The card and logo renderer below is served by the Gitlytics cloud API at api.gitlytics.dev. The gitlytics wheel you install from PyPI contains the traffic CLI, the Python SDK and the local dashboard - it does not contain an SVG card generator. Install the package for traffic analytics; embed the hosted URLs for cards.

Elevate your GitHub profile README with the Gitlytics hosted native, dynamic vector SVG rendering engine. All cards feature crisp typography, custom vector squircle icons, subtle gradient accents, and real-time GitHub GraphQL data.

👤 Flagship Developer Profile Card (Obsidian Slate)
Avatar, bio, verified status, 4 metric squircles & top languages bar

Developer Profile Card
⭐ Account Highlights 2A-2 (Tokyo Night)
Top repository, primary language share, peak year & longevity badge

Account Highlights
📊 Language Diversity Index (Dracula)
Radial diversity score gauge, repo share, byte volume & stack capsules

Language Diversity
📈 Yearly Activity Matrix (Nord)
Commit velocity, issue resolutions, code reviews & contribution cadence

Yearly Activity Matrix

🚀 Instant Markdown Embed

Add any card to your GitHub README.md with a single line of Markdown:

<!-- Replace 'yourusername' and choose your preferred theme -->
![Gitlytics Profile](https://api.gitlytics.dev/api/cards/profile-card/yourusername.svg?theme=obsidian-gold)
🔍 View All 31 Card Slugs (hosted service)
Category Card Slug Focus & Visual Hierarchy
Flagship profile-card Complete overview: Avatar, bio, followers, contributions, languages.
Highlights account-highlights Most active repo, primary language, account longevity milestones.
Languages language-diversity Radial language entropy score gauge + byte volume breakdowns.
Cadence weekly-cadence 7-day cyclical radar heatmap of commit & review activity.
Productivity productive-hours Circadian clock visualization showing peak coding hours.
Velocity commit-velocity High-frequency commit trendlines, averages, and momentum.
Trajectory star-journey Milestone progression towards star milestones.
Reviews review-stats PR reviews conducted, turnaround latency, and acceptance rate.
Matrix yearly-activity Comprehensive yearly breakdown of contributions by category.
Impact open-source-impact Ecosystem reach, community forks, and public issue closure rate.

...and 21 more specialized cards available in the Interactive Embed Studio.

🎨 Explore 33 Color Themes

Supported theme values via ?theme=<name>:

default • dracula • tokyonight • nord • obsidian-gold • synthwave84 • cyberpunk • catppuccin-mocha • gruvbox-dark • monokai • one-dark • solarized-dark • matrix • rose-pine • github-dark • github-light • material-ocean • emerald-dark • amber-minimal • slate-pro • ayu-dark • horizon • shades-of-purple • cobalt2 • night-owl • palenight • laserwave • oceanic-next • dimmed • high-contrast


🏷️ Hosted Multi-Source Tech Badges & Concept Capsules

Served by the hosted service at api.gitlytics.dev - 181 tech logos plus custom text-only capsules. Not part of the pip package.

Generate clean capsule badges for your tech stack. Supports official brand logos plus custom text-only capsules for advanced concepts:

<!-- Official brand logo capsule -->
![FastAPI](https://api.gitlytics.dev/api/badge/tech.svg?slug=fastapi&style=icon_label_value&label=Backend&value=FastAPI&color=009688)

<!-- Custom text-only concept capsule -->
![LLM Arch](https://api.gitlytics.dev/api/badge/tech.svg?label=Arch&value=RAG%2BGraph&style=label_value&color=7c3aed)
Python Badge FastAPI Badge React Badge Docker Badge Actions Badge

🔄 How the Traffic Engine Works

GitHub only preserves 14 days of historical traffic data. Gitlytics automates historical aggregation into an append-only archive:

flowchart LR
    A["GitHub Traffic API\n(14-Day Rolling Window)"] -->|Automated Snapshot| B["Gitlytics Sync Engine"]
    B -->|Deduplicate & Merge| C[("Persistent CSV / Cloud DB\n(Indefinite Retention)")]
    C --> D["Interactive Dashboard"]
    C --> E["Hosted SVG Profile Cards\n(api.gitlytics.dev)"]
    C --> F["AI Health Reports"]

⚡ Setup in Under 2 Minutes:

Use our pre-configured companion GitHub Action that runs automatically every 13 days to snapshot and backup your data:

👉 Deploy the Gitlytics GitHub Traffic Automation Action


📦 Installation

# Core CLI and Python Analytics Engine
pip install gitlytics

# Full Package (Includes React Dashboard Web Server)
pip install "gitlytics[dashboard]"

💻 CLI Quick Reference

# 1. Fetch live 14-day traffic and display formatted ASCII tables
gitlytics fetch --token "ghp_your_token" --print-table

# 2. Filter specific metrics (e.g., views, clones, referrers)
gitlytics fetch --token "ghp_your_token" --metrics views clones

# 3. Synchronize snapshots into local database
gitlytics sync --token "ghp_your_token" --data-dir "./data"

# 4. Schedule automatic sync as a background cron job (e.g. daily at 11 PM)
gitlytics sync --token "ghp_your_token" --data-dir "./data" --schedule-cron "0 23 * * *"

# 5. Launch the React + FastAPI web analytics studio
gitlytics dashboard

# 6. Retrieve cumulative stargazer trajectory for a repository
gitlytics stars owner/repo --token "ghp_your_token"

CLI output contract: the traffic table and the success summary go to stdout; every error and warning goes to stderr. Exit codes are meaningful - 0 success, 1 runtime/upstream failure, 2 bad input - so gitlytics fetch ... > out.csv never mixes diagnostics into your data.


🐍 Native Python SDK

Incorporate Gitlytics directly into custom pipelines, Jupyter notebooks, or scheduled scripts:

import gitlytics

# 1. Fetch traffic data as a pandas DataFrame or timeseries dict
df = gitlytics.fetch_traffic(
    token="ghp_your_token",
    return_format="dataframe"  # Options: "dataframe", "timeseries", "summary"
)

# 2. Sync snapshots and export consolidated dashboard JSON
gitlytics.sync(
    token="ghp_your_token",
    data_dir="./data",
    export_json="./data/export.json"
)

# 3. Query historical cumulative star trajectory
star_points = gitlytics.fetch_star_history(
    owner="ameyachopade",
    repo="gitlytics",
    token="ghp_your_token"
)

# 4. Programmatically serve the web studio on loopback with a pre-loaded token
gitlytics.serve_dashboard(
    host="127.0.0.1",
    port=8080,
    token="ghp_your_token",
    data_dir="./data"
)

📊 Database Schema (24 Daily Metrics)

Gitlytics stores normalized daily records in local CSV files or cloud storage:

Column Type Description
date str ISO 8601 date string (YYYY-MM-DD).
repository str Full GitHub repository name (owner/repo).
is_private bool Privacy state of the repository.
views int Total page views recorded on this day.
unique_visitors int Unique visitors browsing the repository.
clones int Total git clone operations on this day.
unique_cloners int Distinct IP / client clone operations.
stars int Total cumulative stargazer snapshot count.
forks int Total cumulative fork count.
releases int Total repository release count snapshot.
language str Primary programming language.
topics str JSON array of repository tags and topics.
watchers_count int Total watcher count.
pushed_at str Last code push timestamp.
created_at str Repository creation timestamp.
open_issues_count int Total open issues snapshot.
top_referrer str Highest-volume external referral domain.
top_referrer_views int Total views attributed to top referrer.
top_referrer_uniques int Unique visitors attributed to top referrer.
_raw_referrers str Complete JSON breakdown of all referral channels.
top_path str Most frequently visited repository file/path.
top_path_views int Views attributed to the top path.
top_path_uniques int Unique visitors attributed to the top path.
_raw_paths str Complete JSON breakdown of all popular paths.

  • 📦 PyPI Package: Official Python package distribution - the traffic CLI, the Python SDK and the local/self-hosted dashboard.
  • 🌐 Live Dashboard: Production Web UI to explore widgets and inspect traffic.
  • 🖼️ Hosted Card & Logo API: Serves the 31 SVG profile-card slugs (33 themes) and 181 tech-logo capsules. This is a separate hosted service - it is not bundled in the gitlytics wheel.
  • 📚 Documentation: Full API guides, card parameters, and self-hosting documentation.
  • 📝 Engineering Blog: Architecture breakdowns, caching strategies, and performance benchmarks.
  • ⚙️ Traffic Automation Action: Official GitHub Action companion.

⭐ Show Your Support

If Gitlytics has saved your repository data or elevated your profile, please consider giving the repository a ⭐ Star on GitHub - it helps the project grow!


📄 License

Distributed under Apache License 2.0 + Commons Clause v1.0. See LICENSE for full details.

Metadata

Release files for gitlytics 0.7.2

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.2
File Size Uploaded Provenance Actions
gitlytics-0.7.2.tar.gz 1.2 MB With provenance Details for gitlytics-0.7.2.tar.gz

Built distribution (wheel)

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

Total release size: 2.4 MB

Release files / gitlytics-0.7.2.tar.gz

Download URL gitlytics-0.7.2.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
892eb90f59420248585a76ef96893dd6b0749af51b6969bc3ba83e57b3f87347
BLAKE2b-256 checksum
How to use checksums
fde62f491eaaac2825291cd625eefcfd1d11a77e029733f1f75f4424699097e6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

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

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

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Security for gitlytics 0.7.2

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for gitlytics-0.7.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

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