Skip to main content

Workflow Clinic

Workflow Clinic is a GSoC 2026 project focused on improving the portability, reproducibility, and cloud-readiness of scientific workflows.

The project aims to analyze workflow languages such as Nextflow and Snakemake, convert them into a common intermediate representation called WorkflowBundle, and identify workflow portability issues through automated validation and analysis.

By using a common workflow model inspired by the DAW (Data Analysis Workflow) metamodel, Workflow Clinic can reason about workflows independently of their original language and provide consistent diagnostics, recommendations, and future repair capabilities.

Why Workflow Clinic?

Scientific workflows are often tightly coupled to specific execution environments, storage systems, schedulers, or local infrastructure.

This can make workflows difficult to:

  • Share
  • Reproduce
  • Port across platforms
  • Execute in cloud environments
  • Integrate with GA4GH-compliant services

Workflow Clinic aims to help workflow authors identify and resolve these issues before deployment.

Planned Features

Workflow Parsing

  • Nextflow support
  • Snakemake support
  • Common WorkflowBundle representation

Workflow Analysis

  • Portability diagnostics
  • Storage validation
  • Resource validation
  • Metadata validation
  • Workflow structure validation

AI-Assisted Review

  • Rule-based workflow checks
  • AI-assisted diagnostics
  • Confidence-based recommendations

Workflow Repair

  • Suggested fixes
  • Automated transformations
  • Validation of generated fixes

Installation

Clone the Repository

git clone https://github.com/revaarathore11/ga4gh_workflow_clinic_gsoc_2026-.git
cd ga4gh_workflow_clinic_gsoc_2026-

Create a Virtual Environment

python -m venv .venv
source .venv/bin/activate

Install Dependencies

pip install -e ".[dev]"

Development

Run Tests

pytest

Run Linting

ruff check .

Run Formatting

ruff format .

Supported Workflow Languages

Current target languages:

  • Nextflow
  • Snakemake

Potential future support:

  • CWL
  • WDL

Architecture Overview

Workflow Files
    ↓
  Parser
    ↓
WorkflowBundle
    ↓
Rule Engine
    ↓
 AI Critic
    ↓
  Doctor

Standards Alignment

Workflow Clinic is being designed with future compatibility in mind for:

  • GA4GH TES
  • GA4GH WES
  • GA4GH TRS
  • Workflow Run RO-Crate

License

This project is licensed under the Apache License 2.0.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

workflow_clinic-0.19.0.tar.gz (70.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

workflow_clinic-0.19.0-py3-none-any.whl (56.6 kB view details)

Uploaded Python 3

File details

Details for the file workflow_clinic-0.19.0.tar.gz.

File metadata

  • Download URL: workflow_clinic-0.19.0.tar.gz
  • Upload date:
  • Size: 70.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for workflow_clinic-0.19.0.tar.gz
Algorithm Hash digest
SHA256 8a54a8f46dcc075f7dddefaa8cec75e1bcf5a31c1bd9632f7b00c7ea3474fdb3
MD5 f997aa57f06150ca619e77d6f41340d6
BLAKE2b-256 38615f7269777bc13eaa9dc28e0827c0381f6d664794e4b9d048559fc172811e

See more details on using hashes here.

Provenance

The following attestation bundles were made for workflow_clinic-0.19.0.tar.gz:

Publisher: release.yml on ga4gh/ga4gh_workflow_clinic_gsoc_2026

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file workflow_clinic-0.19.0-py3-none-any.whl.

File metadata

File hashes

Hashes for workflow_clinic-0.19.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2755f6fbbe2c5009e88a64196ec3c0edd619cf02d3a68cc44ef3bd98e874f63e
MD5 4865bed11784d0b0fa6a39f4d49f4c7c
BLAKE2b-256 dbccde609e7f4895208fbf5bde2b41a9ab13706cb559c76903c574e29aa4c7fa

See more details on using hashes here.

Provenance

The following attestation bundles were made for workflow_clinic-0.19.0-py3-none-any.whl:

Publisher: release.yml on ga4gh/ga4gh_workflow_clinic_gsoc_2026

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page