Registry / data / github-heatmap

github-heatmap

library2.3.0pypypiunverified

Generate SVG heatmaps and skyline visualizations for GitHub-like contribution graphs. Version 2.3.0 is the latest. Active development with frequent releases.

data devops

pip install github-heatmap

github ↗package ↗

INSTALL

IMPORT

SIG · GITHUB-HEATMAP

github-heatmap

datapythonv2.3.0

Install

2.8s avg

Import

—

Disk

27MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 28.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.8s · import 0.000s · 29MB

27MB installed

● package 27MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GitHubPoster

✓ from github_heatmap import GitHubPoster

✗ from github_heatmap import GitHubPoster

Initialize with a GitHub token, generate a heatmap SVG for a given user and year.

import os from github_heatmap import GitHubPoster poster = GitHubPoster(token=os.environ.get('GITHUB_TOKEN', '')) poster.run(username='example_user', year=2023) with open('output.svg', 'rb') as f: print(f.read()[:100])

gh-heatmap --version

Debug

Known issues

gotchaThe GitHub token must have the 'repo' and 'user' scopes. Using a token without the correct scopes will result in a 403 or empty output.

fix

Generate a token with scopes: repo, user. Or use a fine-grained token with 'public_repo' access for public repos.

affects: all

breakingVersion 2.x changed the API: the main class is now 'GitHubPoster' instead of 'Poster'. The 'run' method now accepts 'year' as integer (not 'years' list).

fix

Update imports: 'from github_heatmap import GitHubPoster'. Pass 'year=2023' instead of 'years=[2023]'.

affects: >=2.0.0

deprecatedThe 'mode' parameter (e.g., 'mode=github') is deprecated. Version 2.3.0 auto-detects the platform.

fix

Remove the 'mode' parameter from the constructor or run() call.

affects: >=2.3.0

Upgrade

Version history

2.3.0latest on PyPI · released Apr 16, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

12 hits · last 30 days

node

Resources

githubhttps://github.com/malinkang/GitHubPoster ↗

packagehttps://pypi.org/project/github-heatmap/ ↗