GitHub Visitor Counter

See where your README visitors come from.

Add one line to your README. Get a live image of your visitors' country flags.

_{This is the counter itself, live, for @ChanMeng666.}

Try it

Paste this into your README and replace YOUR_USERNAME with your GitHub username:

![](https://github-visitor-counter-tau.vercel.app/api?username=YOUR_USERNAME)

No account is needed. A new counter starts from zero and fills up as people visit.

_{&theme=github_dark&columns=4&maxflags=12}

_{&showlabels=true&maxflags=6}

_{&displayMode=miniCounter&miniDisplay=pageviews}

The image at the top is &displayMode=flagMap&mapSize=medium. To pick options by eye, use the dashboard: it previews the counter and writes the line for you.

How it works

flowchart LR
    R([Someone opens<br/>your README]) --> A["/api?username=..."]
    A --> H[Username becomes<br/>a counter ID]
    H --> D[301 redirect]
    D --> F([Flag Counter<br/>draws the image])

Loading

The counting and the image come from Flag Counter. This project gives you the one-line URL, the themes and the dashboard. Responses are cached for one hour.

For your agent

This page is all a person needs. Every parameter, display mode and theme is in the docs: clone the repo and point your coding agent at docs/overview.md and CLAUDE.md.

git clone https://github.com/ChanMeng666/github-visitor-counter.git

_{Full overview · Changelog · Contributing · Security · Support · MIT}

_{Built by Chan Meng.}