Workflow Registry

The official registry of Pegasus workflows — powering the PegasusHub Workflows page.

Structure

workflow-registry/
├── data/
│   └── workflows.json        # Registry index (read by PegasusHub)
├── <workflow-name>.md        # One markdown file per workflow
└── .github/
    ├── ISSUE_TEMPLATE/
    │   └── workflow-submission.yml
    └── pull_request_template.md

Submit a Workflow

There are two ways to submit your Pegasus workflow to the registry:

Option 1 — GitHub Issue (recommended)

Open a new issue using the Submit a Workflow template and fill in all fields. The admin will review and add it to the registry.

Open a submission issue

Option 2 — Pull Request

1. Create a markdown file at the root of the repo using kebab-case (e.g. my-workflow.md)
2. Fill in the YAML frontmatter and workflow documentation (see any existing .md file for reference)
3. Update data/workflows.json to include your workflow entry
4. Open a Pull Request

Workflow File Format

Each .md file must start with YAML frontmatter:

---
github_owner: "your-github-username"
github_repo: "https://github.com/user/repo"
pegasus_version: ">= 5.0.0"
Topic: "bioinformatics"
license: "Apache License 2.0"
last_verified: "YYYY-MM-DD"
image: "https://raw.githubusercontent.com/.../workflow.png"
name: "my-workflow"
description: "What this workflow does."
---

Registry Index

data/workflows.json is the single source of truth consumed by PegasusHub at runtime. It is updated by the maintainers after each approved submission.

Requirements

• Workflow must use Pegasus WMS >= 5.0.0
• Repository must be publicly accessible on GitHub
• Workflow must have been successfully run at least once (provide last_verified date)