How to Add OSSInsight Stats to Your GitHub Profile README

OSSInsight (ossinsight.io) is an open-source intelligence platform for GitHub data, built by PingCAP using TiDB's analytical database capabilities. For individual developers, it generates profile cards that visualize: pull request activity trends over the past 12 months, code review contribution history, programming language distribution across all your repositories, top repositories by star growth, and issue/comment activity over time.

Compared to github-readme-stats, OSSInsight's profile cards offer more granular time-series data and trend visualization. They are particularly valuable for developers who want to show activity trends rather than just cumulative totals — a rising PR count or growing review contributions tells a better story than a static lifetime number.

OSSInsight provides several card types. The developer overview card:

[![OSSInsight](https://next.ossinsight.io/widgets/official/compose-user-dashboard-stats/thumbnail.png?user_id=YOUR_GITHUB_USER_ID&image_size=auto)](https://next.ossinsight.io/analyze/YOUR_GITHUB_USERNAME)

Note: OSSInsight uses your numeric GitHub user ID (not your username). Find it at https://api.github.com/users/YOUR_USERNAME in the "id" field.

For a collaborative stats card showing language distribution:

[![Lang Stats](https://next.ossinsight.io/widgets/official/compose-user-programming-language-radard/thumbnail.png?user_id=YOUR_USER_ID&image_size=auto)](https://next.ossinsight.io/analyze/YOUR_USERNAME)

OSSInsight's widget gallery at ossinsight.io/widgets lets you browse all available card types and copy the correct markdown.

The main customization parameters:

• image_size: auto (full width), or a pixel value like 300
• user_id: Your numeric GitHub user ID (required)
• activity_type: Filter the activity card to a specific type (pr, issue, review, commit)

OSSInsight's analysis pages at ossinsight.io/analyze/YOUR_USERNAME provide a full interactive dashboard that you can link to as a destination for visitors who want to explore your data in more depth. Including this link alongside the card image adds useful context.

For the best visual integration, use OSSInsight cards alongside github-readme-stats cards in a dedicated Analytics or Stats section of your README. OSSInsight's cards are typically wider than stats cards, so placing them full-width below a two-column stats row works well.

If the card shows 'No data found' or appears blank, the most likely cause is using the username instead of the numeric user ID. Find your numeric ID by visiting https://api.github.com/users/YOUR_USERNAME and looking for the "id" field — it is a 6-8 digit number.

OSSInsight indexes public GitHub data but may have a processing delay of a few days for new accounts or accounts with limited activity. If you recently joined GitHub or have very few public contributions, the card may show minimal data.

If the card thumbnail is very small or appears at low resolution, add &image_size=auto to the URL. This tells the service to render at the optimal size for the container rather than a fixed thumbnail size.