hub / github.com/caarlos0/starcharts
github.com/caarlos0/starcharts @v1.11.0
Chat with this repo
154 symbols
512 edges
37 files
32 documented · 21%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
starcharts
Plot your repo stars over time!
Features
Smart Sampling Mode (Large Repository Optimization)
For large repositories with massive amounts of stars, this project uses Smart Sampling Mode to efficiently fetch star history data and render trend charts.
How it works:
- Auto Detection: First requests the first page of GitHub API data and parses the
LinkHeader to get total page count - Mode Switching:
- When total pages ≤
maxSamplePages(default 15 pages, ~1500 stars), fetches all data - When total pages >
maxSamplePages, automatically switches to sampling mode - Uniform Sampling: Evenly selects sample points across all pages to ensure coverage of the complete star growth timeline
- Data Point Extraction: Extracts the timestamp and corresponding star count from the first Stargazer of each sampled page
- Trend Completion: Adds current time and total star count as the final data point to ensure the chart extends to the latest state
Usage
go run main.go
Then browse http://localhost:3000/me/myrepo .
Configuration
Configure via environment variables:
| Variable | Default | Description |
|---|---|---|
REDIS_URL |
redis://localhost:6379 |
Redis cache URL |
GITHUB_TOKENS |
- | GitHub API Token (supports multiple, comma-separated) |
GITHUB_PAGE_SIZE |
100 |
Number of stars per page |
GITHUB_MAX_SAMPLE_PAGES |
15 |
Max sample pages (triggers sampling mode when exceeded) |
GITHUB_MAX_RATE_LIMIT_USAGE |
80 |
API Rate Limit usage threshold percentage |
LISTEN |
127.0.0.1:3000 |
Server listen address |
Example
Extension points exported contracts — how you extend this code
RoundRobiner (Interface)
RoundRobiner can pick a token from a list of tokens. [2 implementers]
internal/roundrobin/roudrobin.go
ValueFormatter (FuncType)
(no doc)
internal/chart/chart.go
Number (Interface)
(no doc)
internal/chart/math.go
Number (Interface)
(no doc)
internal/chart/svg/helpres.go
Core symbols most depended-on inside this repo
Attr
called by 39
internal/chart/svg/path.go
Get
called by 29
internal/cache/cache.go
Height
called by 14
internal/chart/box.go
Width
called by 12
internal/chart/box.go
Close
called by 11
internal/cache/cache.go
Point
called by 11
internal/chart/svg/helpres.go
measureText
called by 8
internal/chart/helpers.go
Translate
called by 8
internal/chart/range.go
Shape
Languages
Go99%
TypeScript1%
Modules by API surface
internal/roundrobin/roudrobin.go14 symbols
internal/chart/box.go13 symbols
internal/chart/svg/path.go11 symbols
internal/chart/math.go11 symbols
internal/github/stars.go10 symbols
internal/roundrobin/roundrobin_test.go8 symbols
internal/github/github.go8 symbols
internal/chart/svg/tag_builder.go8 symbols
internal/cache/cache.go7 symbols
internal/chart/helpers.go6 symbols
internal/chart/series.go5 symbols
controller/helpers.go5 symbols
For agents
$ claude mcp add starcharts \
-- python -m otcore.mcp_server <graph>