generate command

Common options

Option	Applies to	Notes
`--config-path`	Most	Path to `config.yaml` (default: `./config.yaml`)
`--output-path`	Most generators	Override the command's output path

Generates a light-mode SVG banner and automatically derives a dark-mode variant.

uv run python -m scripts.cli generate banner \
  --config-path ./config.yaml \
  --output-path .github/assets/img/banner.svg \
  --title "My Name" \
  --subtitle "Developer" \
  --width 1200 \
  --height 630

Option	Notes
`--title`	Overrides `banner_settings.title`
`--subtitle`	Overrides `banner_settings.subtitle`
`--width`	Overrides `banner_settings.width`
`--height`	Overrides `banner_settings.height`
`--optimize-banner/--no-optimize-banner`	Toggle SVGO post-processing

CLI options take precedence over config values. Calls generate_banner(cfg=BannerConfig(...)) twice — once for light, once for dark.

`generate qr`

uv run python -m scripts.cli generate qr \
  --config-path ./config.yaml \
  --output-path .github/assets/img/qr.png \
  --qr-scale 25 \
  --qr-background-path .github/assets/img/icon.svg

Option	Notes
`--qr-scale`	Module size in pixels
`--qr-background-path`	SVG to embed behind QR modules

`generate word-cloud`

uv run python -m scripts.cli generate word-cloud \
  --config-path ./config.yaml \
  --from-topics-md \
  --output-path .github/assets/img/wordcloud_metaheuristic-anim_by_topics.svg

Option	Notes
`--techs-path`	Custom markdown file with technology data
`--output-path`	Output SVG path
`--prompt`	Optional LLM prompt for keyword curation
`--from-topics-md`	Generate from `.github/assets/topics.md`
`--from-languages-md`	Generate from `.github/assets/languages.md`

`generate generative`

Generates Lorenz-attractor / neural-network / flow-field SVG art seeded from GitHub metrics.

uv run python -m scripts.cli generate generative \
  --metrics-path /tmp/metrics.json

Produces generative-activity.svg, generative-activity-dark.svg, generative-community.svg, generative-community-dark.svg in .github/assets/img/.

`generate animated`

Generates CSS-animated SVGs seeded from commit history data, plus GitHub-safe GIF previews for inline README playback.

uv run python -m scripts.cli generate animated \
  --history-path /tmp/history.json

Produces animated-activity.svg, animated-activity-dark.svg, animated-community.svg, animated-community-dark.svg. Also produces animated-activity.gif, animated-activity-dark.gif, animated-community.gif, animated-community-dark.gif.

scripts/animated_art.py is the CLI entry point and a backward-compatible shim over the generators in scripts/art/*.

`generate skills`

Renders skills.yaml into shields.io badge rows and injects them into the README.

uv run python -m scripts.cli generate skills \
  --skills-path skills.yaml

`generate readme-sections`

Assembles all dynamic README sections and writes them to README.md via marker blocks.

uv run python -m scripts.cli generate readme-sections \
  --config-path ./config.yaml

Synopsis