womm-certification/README.md
Greg Gauthier aac0ca084f docs(readme): add bronze certification seal
Adds a centered image of the WOMM Bronze Certified seal to the README for visual certification display.
2026-04-03 11:37:11 +01:00

1.4 KiB

WOMM Certification Toolkit

WOMM Bronze Certified

Works On My Machine -- The Official Certification Standard

A formal certification framework for the age-old claim "it works on my machine," complete with a bureaucratic standards document, an official seal of approval, and a CLI tool to certify your projects.

Installation

pip install -e .

For PNG badge export support:

pip install -e '.[png]'

Usage

Certify a project

womm certify              # certify current directory
womm certify /path/to/project
womm certify --level gold # target a specific level

Generate a badge

womm badge                              # default: gold, womm-seal.svg
womm badge --level platinum -o seal.svg

Generate a certificate

womm certificate                  # print to stdout
womm certificate -o cert.txt      # save to file

Read the standard

womm standard

Certification Levels

Level Requirements
Bronze Project exists, has source files, no syntax errors
Silver Bronze + tests exist and pass
Gold Silver + README exists, no TODO/FIXME/HACK comments
Platinum Gold + CI config present, git tree is clean

The Standard

See WOMM-STD-001:2026 for the full certification standard.

License

MIT