womm-certification/README.md
Gregory Gauthier 1002b16b81 feat: add initial WOMM Certification Toolkit implementation
Introduces the Works On My Machine certification framework, including:
- CLI tool for project certification and badge/certificate generation
- Certification checks per WOMM-STD-001:2026 standard
- Supporting documents, assets, and tests
- Python package setup with pyproject.toml
2026-04-02 16:30:28 +01:00

1.3 KiB

WOMM Certification Toolkit

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