Workflow Description Language (WDL) local runner & developer toolkit
Project description
miniwdl
Workflow Description Language local runner & developer toolkit for Python 3.8+
Install miniwdl
Installation requires Python 3.8+, pip3 (or conda) and Docker (or Podman/Singularity/udocker). Linux preferred; macOS (Intel) compatible with extra steps. More detail in full documentation.
- Install with pip
: run
pip3 install miniwdl - Install with conda
: run
conda install -c conda-forge miniwdl - Verify your miniwdl installation:
miniwdl run_self_test - Install from source code: see the Dockerfile for dependencies to run
setup.py
Use miniwdl
Run an example bioinformatics WDL pipeline using miniwdl, or learn more abut miniwdl via a short course (screencast examples). If you are new to the WDL language, see the open source learn-wdl course.
- Run an example using a viral genome assembly workflow
- Learn miniwdl course w/screencasts - shown below
- Learn WDL course w/screencasts
Documentation
The online documentation includes a user tutorial, reference manual, and Python development codelabs:
See the Releases for change logs. The Project board shows the current prioritization of issues.
Scaling up
The miniwdl runner schedules WDL tasks in parallel up to the CPUs & memory available on the local host; so a more-powerful host enables larger workloads. Separately-maintained projects can distribute tasks to cloud & HPC backends with a shared filesystem:
- AWS:
- miniwdl-omics-run tool for the Amazon Omics workflow service
- AWS Batch plugin (DIY)
- SLURM
Getting Help
- Open an issue
- OpenWDL Slack (#miniwdl channel)
- Bioinformatics Stack Exchange
Contributing
Feedback and contributions to miniwdl are welcome, via issues and pull requests on this repository. See CONTRIBUTING.md for guidelines and instructions to set up your development environment.
Security
Please disclose security issues responsibly by contacting security@chanzuckerberg.com.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file miniwdl-1.12.1.tar.gz.
File metadata
- Download URL: miniwdl-1.12.1.tar.gz
- Upload date:
- Size: 463.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3eeef08b0f445dfab9ba7bbe9d2ec192227bdbe194ba579808f75386bdfd5e67 |
|
| MD5 | 86167db9fb315b11e1f7439d2565351c |
|
| BLAKE2b-256 | eb8915cc42582cbda3749b48874b330464de64fe42107634f27307372f3387f2 |
File details
Details for the file miniwdl-1.12.1-py3-none-any.whl.
File metadata
- Download URL: miniwdl-1.12.1-py3-none-any.whl
- Upload date:
- Size: 194.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 28e45dde43a071e1b6b00ad25d66ae6bb03b224f8a475bb9fd8c7f979555e9f5 |
|
| MD5 | b52ce8034bab224de2b07ff07e2a1f23 |
|
| BLAKE2b-256 | 5c41f0dda4539c62cdc6ca63257f8a332bc0586ddc783ccb44053e58a4b38979 |
