GitLab OG Image Generator

A CLI tool to generate Open Graph images for GitLab repositories. It fetches metadata from the GitLab API and generates styled OG images with project name, description, and metrics.

✨ Features

• Subcommand-based CLI (gogg repo ...) for extensibility
• Fetches repository metadata from the GitLab API (stars, forks, issues, contributors, languages)
• Generates styled OG images with project name, description, and metrics
• Supports custom icons (URL or local file path)
• Configurable metric visibility (contributors, issues, stars, forks)
• Output formats: PNG, JPG, WebP
• Language color bar based on repository language breakdown

📦 Installation

Using pip:

pip install gitlab-og-image-generator

Using uv:

uv add gitlab-og-image-generator