Docsโ€บBadges
Reference

Score Badges

Embed a live Nixer Score badge in any README. The badge is a shields.io-compatible SVG served at https://nixer.polsia.app/badge/{owner}/{repo}.svg โ€” auto-updated after every re-scan.

๐Ÿ…
Viral distribution mechanism. The Snyk/Codecov/shields.io playbook โ€” every OSS maintainer who pastes the badge into their README hands Nixer a permanent backlink and brand impression on every visitor to their repo.

Badge URL

Canonical URL format
https://nixer.polsia.app/badge/{owner}/{repo}.svg

Replace {owner} and {repo} with the GitHub owner and repository name. Examples:

Examples
https://nixer.polsia.app/badge/langchain-ai/langchain.svg
https://nixer.polsia.app/badge/openai/openai-agents-python.svg
https://nixer.polsia.app/badge/microsoft/autogen.svg

Embedding in your README

Markdown

README.md
[![Nixer Score](https://nixer.polsia.app/badge/{owner}/{repo}.svg)](https://nixer.polsia.app/findings/{owner}/{repo})

HTML

HTML embed
<a href="https://nixer.polsia.app/findings/{owner}/{repo}">
  <img src="https://nixer.polsia.app/badge/{owner}/{repo}.svg" alt="Nixer Score">
</a>

Score colors and grades

GradeScore rangeColorMeaning
A0โ€“10โ–  GreenClean โ€” no significant findings
B11โ€“25โ–  LimeMinor issues only
C26โ€“45โ–  YellowMedium-severity findings present
D46โ€“65โ–  OrangeHigh-severity issues detected
F66โ€“100โ–  RedCritical vulnerabilities present
?โ€”โ–  GreyRepo not yet scanned

Caching behavior

Scored badges are served with Cache-Control: public, max-age=3600 โ€” they refresh hourly. Unknown repos return a grey "unscanned" badge with a 5-minute cache so the score shows up quickly after the first scan completes.

The badge URL never returns a 404 โ€” an unscanned repo gets a grey badge. This prevents broken image icons in READMEs.

Live example

Here's what the badge looks like in practice (using a repo on the leaderboard):

langchain-ai/langchain Nixer Score openai/openai-agents-python Nixer Score microsoft/autogen Nixer Score

Getting badges from the leaderboard

Every entry on the AI Security Leaderboard has a Get badge button. Click it to open a modal with copy-paste Markdown, HTML, and the raw SVG URL โ€” pre-filled with the correct owner/repo.

Edit this page on GitHub