// CLI Framework for GitHub Badge Automation
A CLI and Bash orchestration framework for automating dynamic and static GitHub badges with CI/CD native integration, Snyk security, and multi-platform metrics.
$ Injecting badge assets from local repository cache...
// core_capabilities
Core Python engine with an adaptive Bash orchestrator interface for flexible invocation.
Auto-detects GitHub Actions environment, suppresses local alerts, integrates into pipelines.
Supports
for-the-badge,
flat,
plastic, and more.
Build entire badge sections from a structured JSON blueprint with multi-tier grouping.
Dynamic vulnerability tracking and security posture badges via Snyk integration.
UptimeRobot latency tracking, build stability, and storage metrics rendered in real time.
// badge_gallery
Every badge below is generated dynamically — this page is a live demo.
// interactive_builder
Configure your badge in real time and copy the generated URL.
// cli_simulator
Try running commands directly in your browser — simulates the Badge Gen CLI experience.
generate badge Python 3.12 flat 3776AB
// quick_start
# Clone the repository
git clone https://github.com/gapolli/bagde-gen.git
cd bagde-gen
# Run automated setup
make setup
# or: python badge_gen.py setup# Shorthand Orchestrator Syntax
./badge_gen.sh "Python" "3.12" "flat" "3776AB"
# Advanced Core Engine Syntax
python badge_gen.py --label "Python" --message "3.12" \
--logo "python" --style "flat" --color "3776AB"[
{
"section": "Production Status",
"badges": [
{ "label": "build", "message": "passing", "color": "brightgreen" },
{ "label": "uptime", "message": "99.9%", "color": "green" }
]
}
]// pipeline_flow
Push to main
Actions trigger
Lint & Test
Tag & Sync
Badges refresh
Uses
git-auto-commit-action
with
[skip ci]
to prevent loops.
// contributors
Powered by the GitHub API — always up to date.
// changelog
Release timeline fetched live from GitHub Releases.