Make CWL workflows easier to discover, cite, reuse, and inspect.

Transpiler-Mate is a collection of open-source tools built around Common Workflow Language (CWL). Describe your workflow and its Software Application metadata once, then generate documentation, input templates, citations, research objects, service descriptions, and software bills of materials with independent plugins. These artifacts support FAIR research software practices and supply-chain assessment.

• Explore the repositories
• Get started
• What can you do with Transpiler-Mate?
• Build a plugin
• Edit Software Application metadata

Use Python 3.10 or newer. Install the runtime and the plugins you need in the same Python environment:

python -m pip install transpiler-mate-runtime ${TM_PLUGIN_1} ... ${TM_PLUGIN_N}
transpiler-mate --help

Installed plugins become subcommands of transpiler-mate. Run transpiler-mate <plugin> --help for their options.

The runtime loads CWL documents, prepares a shared context, and discovers installed plugins. A separate API package defines the contracts that let plugins be developed and distributed independently.

With Trivy installed, generate SBOMs for the containers referenced by a selected workflow.

cwl2sbom follows nested workflows, inspects declared images with Trivy, and records image identities and coverage gaps. It produces local artifacts for your pipeline: use ORAS for OCI publication and attachment, then Trivy for downstream vulnerability and license assessment of the exported image SBOMs. Offline vulnerability scanning requires a provisioned database.

See the offline Trivy scanning guide for database preparation, per-image reports, and policy checks.

With a CWL document containing the required Schema.org SoftwareApplication metadata, generate documentation and diagrams.

Use CodeMeta, DataCite, and OGC Records exports to describe workflows for discovery; provide citations with cwl2citation; and package workflows or recorded executions with cwl2ro-crate. invenio-publish handles publication to InvenioRDM or Zenodo.

The cwl2ro-crate distribution registers the command cwl2rocrate. Its optional --run argument accepts an existing CWLProv directory to package execution provenance.

Validate workflow inputs before execution:

The batch plugin runs multiple plugin executions sequentially with the same resolved CWL context. An execution plan in YAML specifies the plugins and their inputs.

Create tmom.yaml in your working directory:

cwl2sbom:
- platform: 'linux/amd64'
  output: 'build/sbom'

cwl2markdown:
- output: 'build/docs'

cwl2puml:
- output: 'build/diagrams'

cwl2webgl:
- output: 'build/explorers'

baseline:
- previous: 'oci://mycompany.org/released.cwl'
  output: 'baseline.json'

Then run:

transpiler-mate batch workflow.cwl#main

Start with the transpiler-mate-plugin-project-template, a Copier template with Python packaging, tests, documentation, and CI. Implement the plugin API and register your package in the transpiler_mate.plugins entry-point group so the runtime can discover it.

Bug reports, examples, documentation improvements, and new plugins are welcome. Open an issue or pull request in the relevant repository, and follow its contribution and development instructions.

This .github repository hosts the organization's landing-page and profile content.