gitlytics 0.7.0__tar.gz → 0.8.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. {gitlytics-0.7.0 → gitlytics-0.8.0}/LICENSE +1 -1
  2. gitlytics-0.8.0/MANIFEST.in +11 -0
  3. gitlytics-0.8.0/PKG-INFO +337 -0
  4. gitlytics-0.8.0/README.md +300 -0
  5. {gitlytics-0.7.0 → gitlytics-0.8.0}/pyproject.toml +28 -16
  6. gitlytics-0.8.0/requirements.txt +6 -0
  7. gitlytics-0.8.0/src/gitlytics/__init__.py +36 -0
  8. gitlytics-0.8.0/src/gitlytics/__main__.py +9 -0
  9. gitlytics-0.8.0/src/gitlytics/_version.py +5 -0
  10. gitlytics-0.8.0/src/gitlytics/api/__init__.py +58 -0
  11. gitlytics-0.8.0/src/gitlytics/api/app.py +35 -0
  12. gitlytics-0.8.0/src/gitlytics/api/cache.py +146 -0
  13. gitlytics-0.8.0/src/gitlytics/api/routes.py +405 -0
  14. gitlytics-0.8.0/src/gitlytics/api/security.py +197 -0
  15. gitlytics-0.8.0/src/gitlytics/automation/__init__.py +29 -0
  16. gitlytics-0.8.0/src/gitlytics/automation/scheduler.py +229 -0
  17. gitlytics-0.8.0/src/gitlytics/automation/storage.py +200 -0
  18. gitlytics-0.8.0/src/gitlytics/cli/__init__.py +12 -0
  19. gitlytics-0.8.0/src/gitlytics/cli/commands.py +211 -0
  20. gitlytics-0.8.0/src/gitlytics/cli/parser.py +174 -0
  21. gitlytics-0.8.0/src/gitlytics/core/__init__.py +103 -0
  22. gitlytics-0.8.0/src/gitlytics/core/client.py +249 -0
  23. gitlytics-0.8.0/src/gitlytics/core/repos.py +199 -0
  24. gitlytics-0.8.0/src/gitlytics/core/stars.py +340 -0
  25. gitlytics-0.8.0/src/gitlytics/core/traffic.py +312 -0
  26. gitlytics-0.8.0/src/gitlytics/core/users.py +206 -0
  27. gitlytics-0.8.0/src/gitlytics/core/validation.py +47 -0
  28. gitlytics-0.8.0/src/gitlytics/exceptions.py +42 -0
  29. gitlytics-0.8.0/src/gitlytics/io/__init__.py +34 -0
  30. gitlytics-0.8.0/src/gitlytics/io/atomic.py +93 -0
  31. gitlytics-0.8.0/src/gitlytics/io/csv.py +102 -0
  32. gitlytics-0.8.0/src/gitlytics/io/formatting.py +101 -0
  33. gitlytics-0.8.0/src/gitlytics/io/payloads.py +446 -0
  34. gitlytics-0.8.0/src/gitlytics/process.py +23 -0
  35. gitlytics-0.8.0/src/gitlytics/sdk.py +287 -0
  36. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/_headers +3 -2
  37. gitlytics-0.8.0/src/gitlytics/static/assets/CardModal-CgS7cwE6.js +1 -0
  38. gitlytics-0.8.0/src/gitlytics/static/assets/CommitActivity-B8loV0zx.js +2 -0
  39. gitlytics-0.8.0/src/gitlytics/static/assets/DashboardPage-CM3TuMN8.js +8 -0
  40. gitlytics-0.8.0/src/gitlytics/static/assets/DashboardView-C-bWABhu.js +2 -0
  41. gitlytics-0.8.0/src/gitlytics/static/assets/ExportModal-Dzj7HavP.js +1 -0
  42. gitlytics-0.8.0/src/gitlytics/static/assets/HeaderNavbar-B34y2mgI.js +1 -0
  43. gitlytics-0.8.0/src/gitlytics/static/assets/SettingsPage-BTwXpn2n.js +1 -0
  44. gitlytics-0.8.0/src/gitlytics/static/assets/UsernameView-UfCI3Zto.js +2 -0
  45. gitlytics-0.8.0/src/gitlytics/static/assets/download-jFI60Api.js +1 -0
  46. gitlytics-0.8.0/src/gitlytics/static/assets/exports-XafIIZGe.js +46 -0
  47. gitlytics-0.8.0/src/gitlytics/static/assets/github-api-nEQh7lEl.js +4 -0
  48. gitlytics-0.8.0/src/gitlytics/static/assets/index-BXb5FSJ3.css +2 -0
  49. gitlytics-0.8.0/src/gitlytics/static/assets/index-DWuGnK2H.js +3 -0
  50. gitlytics-0.7.0/src/gitlytics/static/assets/index.es-zEcWcC3I.js → gitlytics-0.8.0/src/gitlytics/static/assets/index.es-ScXeqmu0.js +1 -1
  51. gitlytics-0.8.0/src/gitlytics/static/assets/session-traffic-store-NbhFxYwD.js +1 -0
  52. gitlytics-0.8.0/src/gitlytics/static/assets/vendor-charts-DJf0ii6C.js +59 -0
  53. gitlytics-0.8.0/src/gitlytics/static/assets/vendor-html2canvas-Du5bbLwR.js +7 -0
  54. gitlytics-0.8.0/src/gitlytics/static/assets/vendor-icons-Dz82alpU.js +1 -0
  55. gitlytics-0.7.0/src/gitlytics/static/assets/jspdf.es.min-DZc1ww8w.js → gitlytics-0.8.0/src/gitlytics/static/assets/vendor-jspdf-CfDsdiuL.js +32 -32
  56. gitlytics-0.8.0/src/gitlytics/static/assets/vendor-query-Db_ymVcz.js +1 -0
  57. gitlytics-0.8.0/src/gitlytics/static/assets/vendor-react-B6nnNKyz.js +9 -0
  58. gitlytics-0.8.0/src/gitlytics/static/assets/vendor-router-ORVwdicZ.js +3 -0
  59. gitlytics-0.8.0/src/gitlytics/static/assets/vendor-ui-C9IATfL8.js +1 -0
  60. gitlytics-0.8.0/src/gitlytics/static/index.html +98 -0
  61. gitlytics-0.8.0/src/gitlytics/static/site.webmanifest +1 -0
  62. gitlytics-0.8.0/src/gitlytics/username.py +12 -0
  63. gitlytics-0.8.0/src/gitlytics.egg-info/PKG-INFO +337 -0
  64. gitlytics-0.8.0/src/gitlytics.egg-info/SOURCES.txt +77 -0
  65. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics.egg-info/requires.txt +1 -1
  66. gitlytics-0.7.0/PKG-INFO +0 -357
  67. gitlytics-0.7.0/README.md +0 -323
  68. gitlytics-0.7.0/src/gitlytics/__init__.py +0 -233
  69. gitlytics-0.7.0/src/gitlytics/__main__.py +0 -9
  70. gitlytics-0.7.0/src/gitlytics/api.py +0 -444
  71. gitlytics-0.7.0/src/gitlytics/automation.py +0 -293
  72. gitlytics-0.7.0/src/gitlytics/cli.py +0 -208
  73. gitlytics-0.7.0/src/gitlytics/core.py +0 -814
  74. gitlytics-0.7.0/src/gitlytics/process.py +0 -328
  75. gitlytics-0.7.0/src/gitlytics/static/_redirects +0 -1
  76. gitlytics-0.7.0/src/gitlytics/static/assets/ExportModal-CqawRJQe.js +0 -1
  77. gitlytics-0.7.0/src/gitlytics/static/assets/html2canvas-Bw0OShmD.js +0 -5
  78. gitlytics-0.7.0/src/gitlytics/static/assets/html2canvas-pro.esm-R_8Rc3By.js +0 -7
  79. gitlytics-0.7.0/src/gitlytics/static/assets/index-B3YVZMEg.js +0 -165
  80. gitlytics-0.7.0/src/gitlytics/static/assets/index-CvFzI4Pz.css +0 -1
  81. gitlytics-0.7.0/src/gitlytics/static/favicon.png +0 -0
  82. gitlytics-0.7.0/src/gitlytics/static/google-search-icon-48x48.png +0 -0
  83. gitlytics-0.7.0/src/gitlytics/static/google-search-icon.png +0 -0
  84. gitlytics-0.7.0/src/gitlytics/static/index.html +0 -71
  85. gitlytics-0.7.0/src/gitlytics/static/llms-full.txt +0 -125
  86. gitlytics-0.7.0/src/gitlytics/static/llms.txt +0 -19
  87. gitlytics-0.7.0/src/gitlytics/static/robots.txt +0 -4
  88. gitlytics-0.7.0/src/gitlytics/static/site.webmanifest +0 -1
  89. gitlytics-0.7.0/src/gitlytics/static/sitemap.xml +0 -18
  90. gitlytics-0.7.0/src/gitlytics.egg-info/PKG-INFO +0 -357
  91. gitlytics-0.7.0/src/gitlytics.egg-info/SOURCES.txt +0 -52
  92. gitlytics-0.7.0/tests/test_api.py +0 -442
  93. gitlytics-0.7.0/tests/test_automation.py +0 -227
  94. gitlytics-0.7.0/tests/test_cli.py +0 -157
  95. gitlytics-0.7.0/tests/test_core.py +0 -331
  96. gitlytics-0.7.0/tests/test_init.py +0 -208
  97. gitlytics-0.7.0/tests/test_process.py +0 -398
  98. gitlytics-0.7.0/tests/test_star_history.py +0 -255
  99. gitlytics-0.7.0/tests/test_username.py +0 -355
  100. {gitlytics-0.7.0 → gitlytics-0.8.0}/setup.cfg +0 -0
  101. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/android-chrome-192x192.png +0 -0
  102. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/android-chrome-512x512.png +0 -0
  103. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/apple-touch-icon.png +0 -0
  104. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/assets/purify.es-Dqk5qvad.js +0 -0
  105. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/assets/rolldown-runtime-XKyaHtl9.js +0 -0
  106. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/favicon-16x16.png +0 -0
  107. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/favicon-32x32.png +0 -0
  108. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/favicon-48x48.png +0 -0
  109. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/favicon.ico +0 -0
  110. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics/static/gitlytics-logo.png +0 -0
  111. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics.egg-info/dependency_links.txt +0 -0
  112. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics.egg-info/entry_points.txt +0 -0
  113. {gitlytics-0.7.0 → gitlytics-0.8.0}/src/gitlytics.egg-info/top_level.txt +0 -0
@@ -211,5 +211,5 @@ Without limiting other conditions in the License, the grant of rights under the
211
211
  For purposes of the foregoing, "Sell" means practicing any or all of the rights granted to you under the License to provide to third parties, for a fee or other consideration (including without limitation fees for hosting or consulting/ support services related to the Software), a product or service whose value derives, entirely or substantially, from the functionality of the Software. Any license notice or attribution required by the License must also include this Commons Clause License Condition notice.
212
212
 
213
213
  Software: Gitlytics
214
- License: Apache 2.0
214
+ License: Apache 2.0 with Commons Clause
215
215
  Licensor: Ameya Sanjay Chopade
@@ -0,0 +1,11 @@
1
+ include LICENSE
2
+ include README.md
3
+ include pyproject.toml
4
+ include requirements.txt
5
+ recursive-include src/gitlytics *
6
+ prune tests
7
+ prune */__pycache__
8
+ prune src/gitlytics/*/__pycache__
9
+ global-exclude *.py[cod]
10
+ global-exclude .env* *.csv *.tmp *.lock
11
+ exclude .coverage
@@ -0,0 +1,337 @@
1
+ Metadata-Version: 2.4
2
+ Name: gitlytics
3
+ Version: 0.8.0
4
+ Summary: Monitor and automate your GitHub repository traffic analytics.
5
+ Author-email: Ameya Chopade <ameyasanjaychopade@gmail.com>
6
+ License-Expression: LicenseRef-Apache-2.0-with-Commons-Clause
7
+ Project-URL: Homepage, https://gitlytics.dev
8
+ Project-URL: Documentation, https://docs.gitlytics.dev
9
+ Project-URL: Repository, https://github.com/ameyachopade/gitlytics
10
+ Project-URL: Bug Tracker, https://github.com/ameyachopade/gitlytics/issues
11
+ Keywords: github,traffic,analytics,automation,cli
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Programming Language :: Python :: 3.11
14
+ Classifier: Programming Language :: Python :: 3.12
15
+ Classifier: Programming Language :: Python :: 3.13
16
+ Classifier: Programming Language :: Python :: 3.14
17
+ Classifier: Operating System :: OS Independent
18
+ Requires-Python: >=3.11
19
+ Description-Content-Type: text/markdown
20
+ License-File: LICENSE
21
+ Requires-Dist: requests>=2.34.2
22
+ Requires-Dist: certifi>=2026.10.23
23
+ Requires-Dist: pandas>=2.2.3
24
+ Requires-Dist: numpy>=1.26.4
25
+ Requires-Dist: croniter>=6.2.4
26
+ Provides-Extra: dashboard
27
+ Requires-Dist: fastapi>=0.162.0; extra == "dashboard"
28
+ Requires-Dist: uvicorn>=0.54.0; extra == "dashboard"
29
+ Requires-Dist: python-multipart>=0.0.33; extra == "dashboard"
30
+ Provides-Extra: dev
31
+ Requires-Dist: pytest>=9.2.0; extra == "dev"
32
+ Requires-Dist: pytest-cov>=7.1.0; extra == "dev"
33
+ Requires-Dist: httpx2>=2.16.2; extra == "dev"
34
+ Requires-Dist: anyio[trio]>=4.16.0; extra == "dev"
35
+ Requires-Dist: python-dotenv>=1.2.4; extra == "dev"
36
+ Dynamic: license-file
37
+
38
+ <div align="center">
39
+
40
+ <img src="https://raw.githubusercontent.com/ameyachopade/gitlytics/main/assets/logo.png" alt="Gitlytics Logo" width="140" />
41
+
42
+ # Gitlytics
43
+ ### Next-Gen GitHub Traffic Intelligence, Dynamic SVG Widgets & Automation
44
+
45
+ [![PyPI version](https://api.gitlytics.dev/api/badge/pypi/gitlytics.svg?label=PyPI)](https://pypi.org/project/gitlytics/)
46
+ [![Python](https://api.gitlytics.dev/api/badge/tech.svg?slug=python&style=icon_label_value&label=Python&value=3.11%2B)](https://www.python.org/) <!-- Python-3.11+ -->
47
+ [![License](https://api.gitlytics.dev/api/badge/static.svg?label=License&message=Apache%202.0%20%2B%20Commons%20Clause&color=blue)](LICENSE)
48
+ [![FastAPI](https://api.gitlytics.dev/api/badge/tech.svg?slug=fastapi&style=icon_label_value&label=Backend&value=FastAPI)](https://fastapi.tiangolo.com/)
49
+ [![React](https://api.gitlytics.dev/api/badge/tech.svg?slug=react&style=icon_label_value&label=Frontend&value=React%2019)](https://react.dev/)
50
+ [![Live Dashboard](https://api.gitlytics.dev/api/badge/static.svg?label=Studio&message=dashboard.gitlytics.dev&color=818cf8)](https://dashboard.gitlytics.dev)
51
+ [![Documentation](https://api.gitlytics.dev/api/badge/static.svg?label=Docs&message=docs.gitlytics.dev&color=10b981)](https://docs.gitlytics.dev)
52
+
53
+ <br/>
54
+
55
+ **The complete developer analytics suite for GitHub.**
56
+ Bypass GitHub's 14-day traffic cliff, track stargazer trajectories, and launch a local or self-hosted analytics dashboard in seconds.
57
+
58
+ > **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`](https://api.gitlytics.dev) - the package does not contain a card generator. See [Ecosystem & Links](#-ecosystem--links).
59
+
60
+ [**Explore Live Dashboard**](https://dashboard.gitlytics.dev) • [**Read the Docs**](https://docs.gitlytics.dev) • [**Engineering Blog**](https://blog.gitlytics.dev) • [**GitHub Action**](https://github.com/ameyachopade/gitlytics-github-traffic-automation)
61
+
62
+ <br/>
63
+
64
+ </div>
65
+
66
+ ---
67
+
68
+ ## ⚡ Highlights at a Glance
69
+
70
+ | Feature | Description |
71
+ | :--- | :--- |
72
+ | **🚨 14-Day Limit Defeated** | Automatically snapshot & merge repository views, clones, referrers, and paths indefinitely. |
73
+ | **📈 Stargazer Trajectories** | Real-time cumulative star growth tracking and milestone timeline projections. |
74
+ | **🤖 AI Health Scorecards** | Cloud AI diagnostics analyzing commit velocity, issue health, PR turnaround, and traffic surges. |
75
+ | **💻 CLI, Python SDK & Web UI** | Use it as a terminal command, import it into Python pipelines, or self-host the full React studio. |
76
+ | **🎨 Hosted SVG Cards & Logos** | The hosted service at [`api.gitlytics.dev`](https://api.gitlytics.dev) renders 31 profile-card slugs in 33 high-contrast themes, plus 181 tech-logo capsules. Not part of the pip package. |
77
+
78
+ ---
79
+
80
+ ## 🎨 Hosted Profile Cards & Widgets
81
+
82
+ > **Hosted service, not the pip package.** The card and logo renderer below is served by the Gitlytics cloud API at [`api.gitlytics.dev`](https://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.
83
+
84
+ 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.
85
+
86
+ ### 🖼️ Featured Card Previews
87
+
88
+ <div align="center">
89
+ <table border="0" width="100%">
90
+ <tr>
91
+ <td align="center" width="50%">
92
+ <b>👤 Flagship Developer Profile Card</b> (Obsidian Slate)<br/>
93
+ <sub>Avatar, bio, verified status, 4 metric squircles & top languages bar</sub><br/><br/>
94
+ <img src="https://api.gitlytics.dev/api/cards/profile-card/demo.svg?theme=default&v=3" alt="Developer Profile Card" width="95%" />
95
+ </td>
96
+ <td align="center" width="50%">
97
+ <b>⭐ Account Highlights 2A-2</b> (Tokyo Night)<br/>
98
+ <sub>Top repository, primary language share, peak year & longevity badge</sub><br/><br/>
99
+ <img src="https://api.gitlytics.dev/api/cards/account-highlights/demo.svg?theme=tokyonight&v=3" alt="Account Highlights" width="95%" />
100
+ </td>
101
+ </tr>
102
+ <tr>
103
+ <td align="center" width="50%">
104
+ <b>📊 Language Diversity Index</b> (Dracula)<br/>
105
+ <sub>Radial diversity score gauge, repo share, byte volume & stack capsules</sub><br/><br/>
106
+ <img src="https://api.gitlytics.dev/api/cards/language-diversity/demo.svg?theme=dracula&v=3" alt="Language Diversity" width="95%" />
107
+ </td>
108
+ <td align="center" width="50%">
109
+ <b>📈 All Contributions</b> (Nord)<br/>
110
+ <sub>Commits, pull requests, issues & code reviews combined</sub><br/><br/>
111
+ <img src="https://api.gitlytics.dev/api/cards/combined-contributions/demo.svg?theme=nord&v=3" alt="All Contributions" width="95%" />
112
+ </td>
113
+ </tr>
114
+ </table>
115
+ </div>
116
+
117
+ ### 🚀 Instant Markdown Embed
118
+
119
+ Add any card to your GitHub `README.md` with a single line of Markdown:
120
+
121
+ ```markdown
122
+ <!-- Replace 'yourusername' and choose your preferred theme -->
123
+ ![Gitlytics Profile](https://api.gitlytics.dev/api/cards/profile-card/yourusername.svg?theme=obsidian-gold)
124
+ ```
125
+
126
+ <details>
127
+ <summary><b>🔍 View All 31 Card Slugs (hosted service)</b></summary>
128
+
129
+ <br/>
130
+
131
+ | Category | Card Slug | Focus & Visual Hierarchy |
132
+ | :--- | :--- | :--- |
133
+ | **Flagship** | `profile-card` | Complete overview: Avatar, bio, followers, contributions, languages. |
134
+ | **Highlights** | `account-highlights` | Most active repo, primary language, account longevity milestones. |
135
+ | **Languages** | `language-diversity` | Radial language entropy score gauge + byte volume breakdowns. |
136
+ | **Cadence** | `weekly-cadence` | 7-day cyclical radar heatmap of commit & review activity. |
137
+ | **Productivity** | `productive-hours` | Circadian clock visualization showing peak coding hours. |
138
+ | **Velocity** | `commit-velocity` | High-frequency commit trendlines, averages, and momentum. |
139
+ | **Trajectory** | `star-journey` | Milestone progression towards star milestones. |
140
+ | **Reviews** | `review-stats` | PR reviews conducted, turnaround latency, and acceptance rate. |
141
+ | **Contributions** | `combined-contributions` | Commits, pull requests, issues & code reviews combined. |
142
+ | **Impact** | `open-source-impact` | Ecosystem reach, community forks, and public issue closure rate. |
143
+
144
+ *...and 21 more specialized cards available in the [Interactive Embed Studio](https://dashboard.gitlytics.dev/widgets).*
145
+
146
+ </details>
147
+
148
+ <details>
149
+ <summary><b>🎨 Explore 33 Color Themes</b></summary>
150
+
151
+ <br/>
152
+
153
+ Supported theme values via `?theme=<name>`:
154
+
155
+ `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`
156
+
157
+ </details>
158
+
159
+ ---
160
+
161
+ ### 🏷️ Hosted Multi-Source Tech Badges & Concept Capsules
162
+
163
+ > Served by the hosted service at [`api.gitlytics.dev`](https://api.gitlytics.dev) - 181 tech logos plus custom text-only capsules. Not part of the pip package.
164
+
165
+ Generate clean capsule badges for your tech stack. Supports official brand logos plus **custom text-only capsules** for advanced concepts:
166
+
167
+ ```markdown
168
+ <!-- Official brand logo capsule -->
169
+ ![FastAPI](https://api.gitlytics.dev/api/badge/tech.svg?slug=fastapi&style=icon_label_value&label=Backend&value=FastAPI&color=009688)
170
+
171
+ <!-- Custom text-only concept capsule -->
172
+ ![LLM Arch](https://api.gitlytics.dev/api/badge/tech.svg?slug=rag&style=icon_label_value&label=Arch&value=RAG%2BGraph&label_color=7c3aed&value_color=7c3aed)
173
+ ```
174
+
175
+ <div align="center">
176
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=python&style=icon_label_value&label=Core&value=Python+3.12&color=3776AB" alt="Python Badge" />
177
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=fastapi&style=icon_label_value&label=API&value=FastAPI&color=009688" alt="FastAPI Badge" />
178
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=react&style=icon_label_value&label=UI&value=React+19&color=61DAFB" alt="React Badge" />
179
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=docker&style=icon_label_value&label=DevOps&value=Docker&color=2496ED" alt="Docker Badge" />
180
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=githubactions&style=icon_label_value&label=CI&value=Actions&color=2088FF" alt="Actions Badge" />
181
+ </div>
182
+
183
+ ---
184
+
185
+ ## 🔄 How the Traffic Engine Works
186
+
187
+ GitHub only preserves **14 days of historical traffic data**. Gitlytics automates historical aggregation into an append-only archive:
188
+
189
+ ```mermaid
190
+ flowchart LR
191
+ A["GitHub Traffic API\n(14-Day Rolling Window)"] -->|Automated Snapshot| B["Gitlytics Sync Engine"]
192
+ B -->|Deduplicate & Merge| C[("Persistent CSV / Cloud DB\n(Indefinite Retention)")]
193
+ C --> D["Interactive Dashboard"]
194
+ C --> E["Hosted SVG Profile Cards\n(api.gitlytics.dev)"]
195
+ C --> F["AI Health Reports"]
196
+ ```
197
+
198
+ ### ⚡ Setup in Under 2 Minutes:
199
+ Use our pre-configured companion GitHub Action that runs automatically every 13 days to snapshot and backup your data:
200
+
201
+ 👉 **[Deploy the Gitlytics GitHub Traffic Automation Action](https://github.com/ameyachopade/gitlytics-github-traffic-automation)**
202
+
203
+ ---
204
+
205
+ ## 📦 Installation
206
+
207
+ ```bash
208
+ # Core CLI and Python Analytics Engine
209
+ pip install gitlytics
210
+
211
+ # Full Package (Includes React Dashboard Web Server)
212
+ pip install "gitlytics[dashboard]"
213
+ ```
214
+
215
+ ---
216
+
217
+ ## 💻 CLI Quick Reference
218
+
219
+ ```bash
220
+ # 1. Fetch live 14-day traffic and display formatted ASCII tables
221
+ gitlytics fetch --token "ghp_your_token" --print-table
222
+
223
+ # 2. Filter specific metrics (e.g., views, clones, referrers)
224
+ gitlytics fetch --token "ghp_your_token" --metrics views clones
225
+
226
+ # 3. Synchronize snapshots into local database
227
+ gitlytics sync --token "ghp_your_token" --data-dir "./data"
228
+
229
+ # 4. Schedule automatic sync as a background cron job (e.g. daily at 11 PM)
230
+ gitlytics sync --token "ghp_your_token" --data-dir "./data" --schedule-cron "0 23 * * *"
231
+
232
+ # 5. Launch the React + FastAPI web analytics studio (loopback 127.0.0.1 by default)
233
+ gitlytics dashboard
234
+
235
+ # 5b. Bind to a non-loopback interface (requires explicit --public-bind; disables pre-loaded tokens)
236
+ gitlytics dashboard --host 0.0.0.0 --public-bind
237
+
238
+ # 6. Retrieve cumulative stargazer trajectory for a repository
239
+ gitlytics stars owner/repo --token "ghp_your_token"
240
+ ```
241
+
242
+ > **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.
243
+ > **Dashboard security:** `gitlytics dashboard` binds to `127.0.0.1` by default, does not promote ambient `GITHUB_TOKEN` automatically, and disables `--token`/`GITLYTICS_TOKEN` on `--public-bind` so remote users must authenticate with their own token. See [`SECURITY.md`](SECURITY.md) for details.
244
+
245
+ ---
246
+
247
+ ## 🐍 Native Python SDK
248
+
249
+ Incorporate Gitlytics directly into custom pipelines, Jupyter notebooks, or scheduled scripts:
250
+
251
+ ```python
252
+ import gitlytics
253
+
254
+ # 1. Fetch traffic data as a pandas DataFrame or timeseries dict
255
+ df = gitlytics.fetch_traffic(
256
+ token="ghp_your_token",
257
+ return_format="dataframe" # Options: "dataframe", "timeseries", "summary"
258
+ )
259
+
260
+ # 2. Sync snapshots and export consolidated dashboard JSON
261
+ gitlytics.sync(
262
+ token="ghp_your_token",
263
+ data_dir="./data",
264
+ export_json="./data/export.json"
265
+ )
266
+
267
+ # 3. Query historical cumulative star trajectory
268
+ star_points = gitlytics.fetch_star_history(
269
+ owner="ameyachopade",
270
+ repo="gitlytics",
271
+ token="ghp_your_token"
272
+ )
273
+
274
+ # 4. Programmatically serve the web studio on loopback with a pre-loaded token
275
+ gitlytics.serve_dashboard(
276
+ host="127.0.0.1",
277
+ port=8080,
278
+ token="ghp_your_token",
279
+ data_dir="./data"
280
+ )
281
+ ```
282
+
283
+ ---
284
+
285
+ ## 📊 Database Schema (24 Daily Metrics)
286
+
287
+ Gitlytics stores normalized daily records in local CSV files or cloud storage:
288
+
289
+ | Column | Type | Description |
290
+ | :--- | :--- | :--- |
291
+ | `date` | `str` | ISO 8601 date string (`YYYY-MM-DD`). |
292
+ | `repository` | `str` | Full GitHub repository name (`owner/repo`). |
293
+ | `is_private` | `bool` | Privacy state of the repository. |
294
+ | `views` | `int` | Total page views recorded on this day. |
295
+ | `unique_visitors` | `int` | Unique visitors browsing the repository. |
296
+ | `clones` | `int` | Total git clone operations on this day. |
297
+ | `unique_cloners` | `int` | Distinct IP / client clone operations. |
298
+ | `stars` | `int` | Total cumulative stargazer snapshot count. |
299
+ | `forks` | `int` | Total cumulative fork count. |
300
+ | `releases` | `int` | Total repository release count snapshot. |
301
+ | `language` | `str` | Primary programming language. |
302
+ | `topics` | `str` | JSON array of repository tags and topics. |
303
+ | `watchers_count` | `int` | Total watcher count. |
304
+ | `pushed_at` | `str` | Last code push timestamp. |
305
+ | `created_at` | `str` | Repository creation timestamp. |
306
+ | `open_issues_count` | `int` | Total open issues snapshot. |
307
+ | `top_referrer` | `str` | Highest-volume external referral domain. |
308
+ | `top_referrer_views` | `int` | Total views attributed to top referrer. |
309
+ | `top_referrer_uniques` | `int` | Unique visitors attributed to top referrer. |
310
+ | `_raw_referrers` | `str` | Complete JSON breakdown of all referral channels. |
311
+ | `top_path` | `str` | Most frequently visited repository file/path. |
312
+ | `top_path_views` | `int` | Views attributed to the top path. |
313
+ | `top_path_uniques` | `int` | Unique visitors attributed to the top path. |
314
+ | `_raw_paths` | `str` | Complete JSON breakdown of all popular paths. |
315
+
316
+ ---
317
+
318
+ ## 🔗 Ecosystem & Links
319
+
320
+ - 📦 **[PyPI Package](https://pypi.org/project/gitlytics/)**: Official Python package distribution - the traffic CLI, the Python SDK and the local/self-hosted dashboard.
321
+ - 🌐 **[Live Dashboard](https://dashboard.gitlytics.dev)**: Production Web UI to explore widgets and inspect traffic.
322
+ - 🖼️ **[Hosted Card & Logo API](https://api.gitlytics.dev)**: 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.
323
+ - 📚 **[Documentation](https://docs.gitlytics.dev)**: Full API guides, card parameters, and self-hosting documentation.
324
+ - 📝 **[Engineering Blog](https://blog.gitlytics.dev)**: Architecture breakdowns, caching strategies, and performance benchmarks.
325
+ - ⚙️ **[Traffic Automation Action](https://github.com/ameyachopade/gitlytics-github-traffic-automation)**: Official GitHub Action companion.
326
+
327
+ ---
328
+
329
+ ## ⭐ Show Your Support
330
+
331
+ If Gitlytics has saved your repository data or elevated your profile, please consider giving the repository a **⭐ Star on [GitHub](https://github.com/ameyachopade/gitlytics)** - it helps the project grow!
332
+
333
+ ---
334
+
335
+ ## 📄 License & Security
336
+
337
+ Distributed under **Apache License 2.0 + Commons Clause v1.0**. See [`LICENSE`](LICENSE) for full details and [`SECURITY.md`](SECURITY.md) for our security policy and vulnerability reporting process.
@@ -0,0 +1,300 @@
1
+ <div align="center">
2
+
3
+ <img src="https://raw.githubusercontent.com/ameyachopade/gitlytics/main/assets/logo.png" alt="Gitlytics Logo" width="140" />
4
+
5
+ # Gitlytics
6
+ ### Next-Gen GitHub Traffic Intelligence, Dynamic SVG Widgets & Automation
7
+
8
+ [![PyPI version](https://api.gitlytics.dev/api/badge/pypi/gitlytics.svg?label=PyPI)](https://pypi.org/project/gitlytics/)
9
+ [![Python](https://api.gitlytics.dev/api/badge/tech.svg?slug=python&style=icon_label_value&label=Python&value=3.11%2B)](https://www.python.org/) <!-- Python-3.11+ -->
10
+ [![License](https://api.gitlytics.dev/api/badge/static.svg?label=License&message=Apache%202.0%20%2B%20Commons%20Clause&color=blue)](LICENSE)
11
+ [![FastAPI](https://api.gitlytics.dev/api/badge/tech.svg?slug=fastapi&style=icon_label_value&label=Backend&value=FastAPI)](https://fastapi.tiangolo.com/)
12
+ [![React](https://api.gitlytics.dev/api/badge/tech.svg?slug=react&style=icon_label_value&label=Frontend&value=React%2019)](https://react.dev/)
13
+ [![Live Dashboard](https://api.gitlytics.dev/api/badge/static.svg?label=Studio&message=dashboard.gitlytics.dev&color=818cf8)](https://dashboard.gitlytics.dev)
14
+ [![Documentation](https://api.gitlytics.dev/api/badge/static.svg?label=Docs&message=docs.gitlytics.dev&color=10b981)](https://docs.gitlytics.dev)
15
+
16
+ <br/>
17
+
18
+ **The complete developer analytics suite for GitHub.**
19
+ Bypass GitHub's 14-day traffic cliff, track stargazer trajectories, and launch a local or self-hosted analytics dashboard in seconds.
20
+
21
+ > **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`](https://api.gitlytics.dev) - the package does not contain a card generator. See [Ecosystem & Links](#-ecosystem--links).
22
+
23
+ [**Explore Live Dashboard**](https://dashboard.gitlytics.dev) • [**Read the Docs**](https://docs.gitlytics.dev) • [**Engineering Blog**](https://blog.gitlytics.dev) • [**GitHub Action**](https://github.com/ameyachopade/gitlytics-github-traffic-automation)
24
+
25
+ <br/>
26
+
27
+ </div>
28
+
29
+ ---
30
+
31
+ ## ⚡ Highlights at a Glance
32
+
33
+ | Feature | Description |
34
+ | :--- | :--- |
35
+ | **🚨 14-Day Limit Defeated** | Automatically snapshot & merge repository views, clones, referrers, and paths indefinitely. |
36
+ | **📈 Stargazer Trajectories** | Real-time cumulative star growth tracking and milestone timeline projections. |
37
+ | **🤖 AI Health Scorecards** | Cloud AI diagnostics analyzing commit velocity, issue health, PR turnaround, and traffic surges. |
38
+ | **💻 CLI, Python SDK & Web UI** | Use it as a terminal command, import it into Python pipelines, or self-host the full React studio. |
39
+ | **🎨 Hosted SVG Cards & Logos** | The hosted service at [`api.gitlytics.dev`](https://api.gitlytics.dev) renders 31 profile-card slugs in 33 high-contrast themes, plus 181 tech-logo capsules. Not part of the pip package. |
40
+
41
+ ---
42
+
43
+ ## 🎨 Hosted Profile Cards & Widgets
44
+
45
+ > **Hosted service, not the pip package.** The card and logo renderer below is served by the Gitlytics cloud API at [`api.gitlytics.dev`](https://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.
46
+
47
+ 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.
48
+
49
+ ### 🖼️ Featured Card Previews
50
+
51
+ <div align="center">
52
+ <table border="0" width="100%">
53
+ <tr>
54
+ <td align="center" width="50%">
55
+ <b>👤 Flagship Developer Profile Card</b> (Obsidian Slate)<br/>
56
+ <sub>Avatar, bio, verified status, 4 metric squircles & top languages bar</sub><br/><br/>
57
+ <img src="https://api.gitlytics.dev/api/cards/profile-card/demo.svg?theme=default&v=3" alt="Developer Profile Card" width="95%" />
58
+ </td>
59
+ <td align="center" width="50%">
60
+ <b>⭐ Account Highlights 2A-2</b> (Tokyo Night)<br/>
61
+ <sub>Top repository, primary language share, peak year & longevity badge</sub><br/><br/>
62
+ <img src="https://api.gitlytics.dev/api/cards/account-highlights/demo.svg?theme=tokyonight&v=3" alt="Account Highlights" width="95%" />
63
+ </td>
64
+ </tr>
65
+ <tr>
66
+ <td align="center" width="50%">
67
+ <b>📊 Language Diversity Index</b> (Dracula)<br/>
68
+ <sub>Radial diversity score gauge, repo share, byte volume & stack capsules</sub><br/><br/>
69
+ <img src="https://api.gitlytics.dev/api/cards/language-diversity/demo.svg?theme=dracula&v=3" alt="Language Diversity" width="95%" />
70
+ </td>
71
+ <td align="center" width="50%">
72
+ <b>📈 All Contributions</b> (Nord)<br/>
73
+ <sub>Commits, pull requests, issues & code reviews combined</sub><br/><br/>
74
+ <img src="https://api.gitlytics.dev/api/cards/combined-contributions/demo.svg?theme=nord&v=3" alt="All Contributions" width="95%" />
75
+ </td>
76
+ </tr>
77
+ </table>
78
+ </div>
79
+
80
+ ### 🚀 Instant Markdown Embed
81
+
82
+ Add any card to your GitHub `README.md` with a single line of Markdown:
83
+
84
+ ```markdown
85
+ <!-- Replace 'yourusername' and choose your preferred theme -->
86
+ ![Gitlytics Profile](https://api.gitlytics.dev/api/cards/profile-card/yourusername.svg?theme=obsidian-gold)
87
+ ```
88
+
89
+ <details>
90
+ <summary><b>🔍 View All 31 Card Slugs (hosted service)</b></summary>
91
+
92
+ <br/>
93
+
94
+ | Category | Card Slug | Focus & Visual Hierarchy |
95
+ | :--- | :--- | :--- |
96
+ | **Flagship** | `profile-card` | Complete overview: Avatar, bio, followers, contributions, languages. |
97
+ | **Highlights** | `account-highlights` | Most active repo, primary language, account longevity milestones. |
98
+ | **Languages** | `language-diversity` | Radial language entropy score gauge + byte volume breakdowns. |
99
+ | **Cadence** | `weekly-cadence` | 7-day cyclical radar heatmap of commit & review activity. |
100
+ | **Productivity** | `productive-hours` | Circadian clock visualization showing peak coding hours. |
101
+ | **Velocity** | `commit-velocity` | High-frequency commit trendlines, averages, and momentum. |
102
+ | **Trajectory** | `star-journey` | Milestone progression towards star milestones. |
103
+ | **Reviews** | `review-stats` | PR reviews conducted, turnaround latency, and acceptance rate. |
104
+ | **Contributions** | `combined-contributions` | Commits, pull requests, issues & code reviews combined. |
105
+ | **Impact** | `open-source-impact` | Ecosystem reach, community forks, and public issue closure rate. |
106
+
107
+ *...and 21 more specialized cards available in the [Interactive Embed Studio](https://dashboard.gitlytics.dev/widgets).*
108
+
109
+ </details>
110
+
111
+ <details>
112
+ <summary><b>🎨 Explore 33 Color Themes</b></summary>
113
+
114
+ <br/>
115
+
116
+ Supported theme values via `?theme=<name>`:
117
+
118
+ `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`
119
+
120
+ </details>
121
+
122
+ ---
123
+
124
+ ### 🏷️ Hosted Multi-Source Tech Badges & Concept Capsules
125
+
126
+ > Served by the hosted service at [`api.gitlytics.dev`](https://api.gitlytics.dev) - 181 tech logos plus custom text-only capsules. Not part of the pip package.
127
+
128
+ Generate clean capsule badges for your tech stack. Supports official brand logos plus **custom text-only capsules** for advanced concepts:
129
+
130
+ ```markdown
131
+ <!-- Official brand logo capsule -->
132
+ ![FastAPI](https://api.gitlytics.dev/api/badge/tech.svg?slug=fastapi&style=icon_label_value&label=Backend&value=FastAPI&color=009688)
133
+
134
+ <!-- Custom text-only concept capsule -->
135
+ ![LLM Arch](https://api.gitlytics.dev/api/badge/tech.svg?slug=rag&style=icon_label_value&label=Arch&value=RAG%2BGraph&label_color=7c3aed&value_color=7c3aed)
136
+ ```
137
+
138
+ <div align="center">
139
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=python&style=icon_label_value&label=Core&value=Python+3.12&color=3776AB" alt="Python Badge" />
140
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=fastapi&style=icon_label_value&label=API&value=FastAPI&color=009688" alt="FastAPI Badge" />
141
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=react&style=icon_label_value&label=UI&value=React+19&color=61DAFB" alt="React Badge" />
142
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=docker&style=icon_label_value&label=DevOps&value=Docker&color=2496ED" alt="Docker Badge" />
143
+ <img src="https://api.gitlytics.dev/api/badge/tech.svg?slug=githubactions&style=icon_label_value&label=CI&value=Actions&color=2088FF" alt="Actions Badge" />
144
+ </div>
145
+
146
+ ---
147
+
148
+ ## 🔄 How the Traffic Engine Works
149
+
150
+ GitHub only preserves **14 days of historical traffic data**. Gitlytics automates historical aggregation into an append-only archive:
151
+
152
+ ```mermaid
153
+ flowchart LR
154
+ A["GitHub Traffic API\n(14-Day Rolling Window)"] -->|Automated Snapshot| B["Gitlytics Sync Engine"]
155
+ B -->|Deduplicate & Merge| C[("Persistent CSV / Cloud DB\n(Indefinite Retention)")]
156
+ C --> D["Interactive Dashboard"]
157
+ C --> E["Hosted SVG Profile Cards\n(api.gitlytics.dev)"]
158
+ C --> F["AI Health Reports"]
159
+ ```
160
+
161
+ ### ⚡ Setup in Under 2 Minutes:
162
+ Use our pre-configured companion GitHub Action that runs automatically every 13 days to snapshot and backup your data:
163
+
164
+ 👉 **[Deploy the Gitlytics GitHub Traffic Automation Action](https://github.com/ameyachopade/gitlytics-github-traffic-automation)**
165
+
166
+ ---
167
+
168
+ ## 📦 Installation
169
+
170
+ ```bash
171
+ # Core CLI and Python Analytics Engine
172
+ pip install gitlytics
173
+
174
+ # Full Package (Includes React Dashboard Web Server)
175
+ pip install "gitlytics[dashboard]"
176
+ ```
177
+
178
+ ---
179
+
180
+ ## 💻 CLI Quick Reference
181
+
182
+ ```bash
183
+ # 1. Fetch live 14-day traffic and display formatted ASCII tables
184
+ gitlytics fetch --token "ghp_your_token" --print-table
185
+
186
+ # 2. Filter specific metrics (e.g., views, clones, referrers)
187
+ gitlytics fetch --token "ghp_your_token" --metrics views clones
188
+
189
+ # 3. Synchronize snapshots into local database
190
+ gitlytics sync --token "ghp_your_token" --data-dir "./data"
191
+
192
+ # 4. Schedule automatic sync as a background cron job (e.g. daily at 11 PM)
193
+ gitlytics sync --token "ghp_your_token" --data-dir "./data" --schedule-cron "0 23 * * *"
194
+
195
+ # 5. Launch the React + FastAPI web analytics studio (loopback 127.0.0.1 by default)
196
+ gitlytics dashboard
197
+
198
+ # 5b. Bind to a non-loopback interface (requires explicit --public-bind; disables pre-loaded tokens)
199
+ gitlytics dashboard --host 0.0.0.0 --public-bind
200
+
201
+ # 6. Retrieve cumulative stargazer trajectory for a repository
202
+ gitlytics stars owner/repo --token "ghp_your_token"
203
+ ```
204
+
205
+ > **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.
206
+ > **Dashboard security:** `gitlytics dashboard` binds to `127.0.0.1` by default, does not promote ambient `GITHUB_TOKEN` automatically, and disables `--token`/`GITLYTICS_TOKEN` on `--public-bind` so remote users must authenticate with their own token. See [`SECURITY.md`](SECURITY.md) for details.
207
+
208
+ ---
209
+
210
+ ## 🐍 Native Python SDK
211
+
212
+ Incorporate Gitlytics directly into custom pipelines, Jupyter notebooks, or scheduled scripts:
213
+
214
+ ```python
215
+ import gitlytics
216
+
217
+ # 1. Fetch traffic data as a pandas DataFrame or timeseries dict
218
+ df = gitlytics.fetch_traffic(
219
+ token="ghp_your_token",
220
+ return_format="dataframe" # Options: "dataframe", "timeseries", "summary"
221
+ )
222
+
223
+ # 2. Sync snapshots and export consolidated dashboard JSON
224
+ gitlytics.sync(
225
+ token="ghp_your_token",
226
+ data_dir="./data",
227
+ export_json="./data/export.json"
228
+ )
229
+
230
+ # 3. Query historical cumulative star trajectory
231
+ star_points = gitlytics.fetch_star_history(
232
+ owner="ameyachopade",
233
+ repo="gitlytics",
234
+ token="ghp_your_token"
235
+ )
236
+
237
+ # 4. Programmatically serve the web studio on loopback with a pre-loaded token
238
+ gitlytics.serve_dashboard(
239
+ host="127.0.0.1",
240
+ port=8080,
241
+ token="ghp_your_token",
242
+ data_dir="./data"
243
+ )
244
+ ```
245
+
246
+ ---
247
+
248
+ ## 📊 Database Schema (24 Daily Metrics)
249
+
250
+ Gitlytics stores normalized daily records in local CSV files or cloud storage:
251
+
252
+ | Column | Type | Description |
253
+ | :--- | :--- | :--- |
254
+ | `date` | `str` | ISO 8601 date string (`YYYY-MM-DD`). |
255
+ | `repository` | `str` | Full GitHub repository name (`owner/repo`). |
256
+ | `is_private` | `bool` | Privacy state of the repository. |
257
+ | `views` | `int` | Total page views recorded on this day. |
258
+ | `unique_visitors` | `int` | Unique visitors browsing the repository. |
259
+ | `clones` | `int` | Total git clone operations on this day. |
260
+ | `unique_cloners` | `int` | Distinct IP / client clone operations. |
261
+ | `stars` | `int` | Total cumulative stargazer snapshot count. |
262
+ | `forks` | `int` | Total cumulative fork count. |
263
+ | `releases` | `int` | Total repository release count snapshot. |
264
+ | `language` | `str` | Primary programming language. |
265
+ | `topics` | `str` | JSON array of repository tags and topics. |
266
+ | `watchers_count` | `int` | Total watcher count. |
267
+ | `pushed_at` | `str` | Last code push timestamp. |
268
+ | `created_at` | `str` | Repository creation timestamp. |
269
+ | `open_issues_count` | `int` | Total open issues snapshot. |
270
+ | `top_referrer` | `str` | Highest-volume external referral domain. |
271
+ | `top_referrer_views` | `int` | Total views attributed to top referrer. |
272
+ | `top_referrer_uniques` | `int` | Unique visitors attributed to top referrer. |
273
+ | `_raw_referrers` | `str` | Complete JSON breakdown of all referral channels. |
274
+ | `top_path` | `str` | Most frequently visited repository file/path. |
275
+ | `top_path_views` | `int` | Views attributed to the top path. |
276
+ | `top_path_uniques` | `int` | Unique visitors attributed to the top path. |
277
+ | `_raw_paths` | `str` | Complete JSON breakdown of all popular paths. |
278
+
279
+ ---
280
+
281
+ ## 🔗 Ecosystem & Links
282
+
283
+ - 📦 **[PyPI Package](https://pypi.org/project/gitlytics/)**: Official Python package distribution - the traffic CLI, the Python SDK and the local/self-hosted dashboard.
284
+ - 🌐 **[Live Dashboard](https://dashboard.gitlytics.dev)**: Production Web UI to explore widgets and inspect traffic.
285
+ - 🖼️ **[Hosted Card & Logo API](https://api.gitlytics.dev)**: 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.
286
+ - 📚 **[Documentation](https://docs.gitlytics.dev)**: Full API guides, card parameters, and self-hosting documentation.
287
+ - 📝 **[Engineering Blog](https://blog.gitlytics.dev)**: Architecture breakdowns, caching strategies, and performance benchmarks.
288
+ - ⚙️ **[Traffic Automation Action](https://github.com/ameyachopade/gitlytics-github-traffic-automation)**: Official GitHub Action companion.
289
+
290
+ ---
291
+
292
+ ## ⭐ Show Your Support
293
+
294
+ If Gitlytics has saved your repository data or elevated your profile, please consider giving the repository a **⭐ Star on [GitHub](https://github.com/ameyachopade/gitlytics)** - it helps the project grow!
295
+
296
+ ---
297
+
298
+ ## 📄 License & Security
299
+
300
+ Distributed under **Apache License 2.0 + Commons Clause v1.0**. See [`LICENSE`](LICENSE) for full details and [`SECURITY.md`](SECURITY.md) for our security policy and vulnerability reporting process.