<div
align="center"
>
<img
src="https://raw.githubusercontent.com/cylc/cylc-admin/master/docs/img/cylc-logo.svg"
width="50%"
/>
[](https://pypi.org/project/cylc-flow/)
[](https://anaconda.org/conda-forge/cylc-flow)
[](https://matrix.to/#/#cylc-general:matrix.org)
[](https://cylc.discourse.group/)
[](https://cylc.github.io/cylc-doc/stable/html/index.html)
</div>
Cylc (pronounced silk) is a general purpose workflow engine that also
manages cycling systems very efficiently. It is used in production weather,
climate, and environmental forecasting on HPC, but is not specialized to those
domains.
### Quick Start
[Installation](https://cylc.github.io/cylc-doc/stable/html/installation.html) |
[Documentation](https://cylc.github.io/cylc-doc/stable/html/index.html)
```bash
# install cylc
conda install cylc-flow
# extract an example to run
cylc get-resources examples/integer-cycling
# install and run it
cylc vip integer-cycling # vip = validate, install and play
# watch it run
cylc tui integer-cycling
```
### The Cylc Ecosystem
- [cylc-flow](https://github.com/cylc/cylc-flow) - The core Cylc Scheduler for defining and running workflows.
- [cylc-uiserver](https://github.com/cylc/cylc-uiserver) - The web-based Cylc graphical user interface for monitoring and controlling workflows.
- [cylc-rose](https://github.com/cylc/cylc-rose) - Provides integration with [Rose](http://metomi.github.io/rose/).
### Migrating From Cylc 7
[Migration Guide](https://cylc.github.io/cylc-doc/stable/html/7-to-8/index.html)
| [Migration Support](https://cylc.discourse.group/c/cylc/7-to-8/13)
Cylc 8 can run most Cylc 7 workflows in compatibility mode with little to no
changes, go through the
[migration guide](https://cylc.github.io/cylc-doc/stable/html/7-to-8/index.html)
for more details.
Quick summary of major changes:
* Python 2 -> 3.
* Internal communications converted from HTTPS to ZMQ (TCP).
* PyGTK GUIs replaced by:
* Terminal user interface (TUI) included in cylc-flow.
* Web user interface provided by the cylc-uiserver package.
* A new scheduling algorithm with support for branched workflows.
* Command line changes:
* `cylc run <id>` -> `cylc play <id>`
* `cylc restart <id>` -> `cylc play <id>`
* `rose suite-run` -> `cylc install; cylc play <id>`
* The core package containing Cylc scheduler program has been renamed cylc-flow.
* Cylc review has been removed, the Cylc 7 version remains Cylc 8 compatible.
### Citations & Publications
[](https://zenodo.org/badge/latestdoi/1836229)
[](https://doi.org/10.21105/joss.00737)
[](https://ieeexplore.ieee.org/document/8675433)
### Copyright and Terms of Use
[](https://github.com/cylc/cylc-flow/blob/master/COPYING)
Copyright (C) 2008-<span actions:bind='current-year'>2025</span> NIWA & British Crown (Met Office) & Contributors.
Cylc is free software: you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version.
Cylc is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
Cylc. If not, see [GNU licenses](http://www.gnu.org/licenses/).
### Contributing
[](https://github.com/cylc/cylc-flow/graphs/contributors)
[](https://github.com/cylc/cylc-flow/commits/master)
[](https://github.com/cylc/cylc-flow/commits/master)
Contributions welcome:
* Read the [contributing](https://github.com/cylc/cylc-flow/blob/master/CONTRIBUTING.md) page.
* Development setup instructions are in the
[developer docs](https://cylc.github.io/cylc-admin/#cylc-8-developer-docs).
* Involved change proposals can be found in the
[admin pages](https://cylc.github.io/cylc-admin/#change-proposals).
* Touch base in the
[developers chat](https://matrix.to/#/#cylc-general:matrix.org).
This repository contains some code that was generated by GitHub Copilot.
Raw data
{
"_id": null,
"home_page": "https://cylc.org/",
"name": "cylc-flow",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "cycling-workflows, hpc, job-scheduler, metascheduler, workflow-automation, workflow-engine, workflow-management, scheduling",
"author": "Hilary Oliver",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/0d/a8/e775f29e021024b0c97ffe7b4dc443e6b47420416f08c97d2a8cb7e74d2a/cylc_flow-8.4.0.tar.gz",
"platform": "any",
"description": "<div\n align=\"center\"\n>\n<img\n src=\"https://raw.githubusercontent.com/cylc/cylc-admin/master/docs/img/cylc-logo.svg\"\n width=\"50%\"\n/>\n\n[](https://pypi.org/project/cylc-flow/)\n[](https://anaconda.org/conda-forge/cylc-flow)\n[](https://matrix.to/#/#cylc-general:matrix.org)\n[](https://cylc.discourse.group/)\n[](https://cylc.github.io/cylc-doc/stable/html/index.html)\n\n</div>\n\nCylc (pronounced silk) is a general purpose workflow engine that also\nmanages cycling systems very efficiently. It is used in production weather,\nclimate, and environmental forecasting on HPC, but is not specialized to those\ndomains.\n\n### Quick Start\n\n\n[Installation](https://cylc.github.io/cylc-doc/stable/html/installation.html) |\n[Documentation](https://cylc.github.io/cylc-doc/stable/html/index.html)\n\n```bash\n# install cylc\nconda install cylc-flow\n\n# extract an example to run\ncylc get-resources examples/integer-cycling\n\n# install and run it\ncylc vip integer-cycling # vip = validate, install and play\n\n# watch it run\ncylc tui integer-cycling\n```\n\n### The Cylc Ecosystem\n\n- [cylc-flow](https://github.com/cylc/cylc-flow) - The core Cylc Scheduler for defining and running workflows.\n- [cylc-uiserver](https://github.com/cylc/cylc-uiserver) - The web-based Cylc graphical user interface for monitoring and controlling workflows.\n- [cylc-rose](https://github.com/cylc/cylc-rose) - Provides integration with [Rose](http://metomi.github.io/rose/).\n\n### Migrating From Cylc 7\n\n[Migration Guide](https://cylc.github.io/cylc-doc/stable/html/7-to-8/index.html)\n| [Migration Support](https://cylc.discourse.group/c/cylc/7-to-8/13)\n\nCylc 8 can run most Cylc 7 workflows in compatibility mode with little to no\nchanges, go through the\n[migration guide](https://cylc.github.io/cylc-doc/stable/html/7-to-8/index.html)\nfor more details.\n\nQuick summary of major changes:\n\n* Python 2 -> 3.\n* Internal communications converted from HTTPS to ZMQ (TCP).\n* PyGTK GUIs replaced by:\n * Terminal user interface (TUI) included in cylc-flow.\n * Web user interface provided by the cylc-uiserver package.\n* A new scheduling algorithm with support for branched workflows.\n* Command line changes:\n * `cylc run <id>` -> `cylc play <id>`\n * `cylc restart <id>` -> `cylc play <id>`\n * `rose suite-run` -> `cylc install; cylc play <id>`\n* The core package containing Cylc scheduler program has been renamed cylc-flow.\n* Cylc review has been removed, the Cylc 7 version remains Cylc 8 compatible.\n\n\n### Citations & Publications\n\n[](https://zenodo.org/badge/latestdoi/1836229)\n[](https://doi.org/10.21105/joss.00737)\n[](https://ieeexplore.ieee.org/document/8675433)\n\n### Copyright and Terms of Use\n\n[](https://github.com/cylc/cylc-flow/blob/master/COPYING)\n\nCopyright (C) 2008-<span actions:bind='current-year'>2025</span> NIWA & British Crown (Met Office) & Contributors.\n\nCylc is free software: you can redistribute it and/or modify it under the terms\nof the GNU General Public License as published by the Free Software Foundation,\neither version 3 of the License, or (at your option) any later version.\n\nCylc is distributed in the hope that it will be useful, but WITHOUT ANY\nWARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A\nPARTICULAR PURPOSE. See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with\nCylc. If not, see [GNU licenses](http://www.gnu.org/licenses/).\n\n### Contributing\n\n[](https://github.com/cylc/cylc-flow/graphs/contributors)\n[](https://github.com/cylc/cylc-flow/commits/master)\n[](https://github.com/cylc/cylc-flow/commits/master)\n\nContributions welcome:\n\n* Read the [contributing](https://github.com/cylc/cylc-flow/blob/master/CONTRIBUTING.md) page.\n* Development setup instructions are in the\n [developer docs](https://cylc.github.io/cylc-admin/#cylc-8-developer-docs).\n* Involved change proposals can be found in the\n [admin pages](https://cylc.github.io/cylc-admin/#change-proposals).\n* Touch base in the\n [developers chat](https://matrix.to/#/#cylc-general:matrix.org).\n\nThis repository contains some code that was generated by GitHub Copilot.\n",
"bugtrack_url": null,
"license": "GPL",
"summary": "A workflow engine for cycling systems",
"version": "8.4.0",
"project_urls": {
"Documentation": "https://cylc.github.io/cylc-doc/stable/html/index.html",
"Homepage": "https://cylc.org/",
"Source": "https://github.com/cylc/cylc-flow",
"Tracker": "https://github.com/cylc/cylc-flow/issues"
},
"split_keywords": [
"cycling-workflows",
" hpc",
" job-scheduler",
" metascheduler",
" workflow-automation",
" workflow-engine",
" workflow-management",
" scheduling"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d4c739ec3cfa6f9c77544fa6573f2b168d88b5b72a6bab74ff7b5c9c334d478c",
"md5": "1259feb21a0bcb818f83fb264a2a1483",
"sha256": "fb52c70fa1bd987d1d1c9531cc16025aab18568b30cc4c2bf0a899a8b2bc94ed"
},
"downloads": -1,
"filename": "cylc_flow-8.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1259feb21a0bcb818f83fb264a2a1483",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 1016052,
"upload_time": "2025-01-08T14:50:20",
"upload_time_iso_8601": "2025-01-08T14:50:20.249387Z",
"url": "https://files.pythonhosted.org/packages/d4/c7/39ec3cfa6f9c77544fa6573f2b168d88b5b72a6bab74ff7b5c9c334d478c/cylc_flow-8.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0da8e775f29e021024b0c97ffe7b4dc443e6b47420416f08c97d2a8cb7e74d2a",
"md5": "0b16209b7066db186bb88d90d0cad761",
"sha256": "d3a6c644f1be8564131794f885f616aa31d68f8ed4887872b070ac8933f64936"
},
"downloads": -1,
"filename": "cylc_flow-8.4.0.tar.gz",
"has_sig": false,
"md5_digest": "0b16209b7066db186bb88d90d0cad761",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 788690,
"upload_time": "2025-01-08T14:50:21",
"upload_time_iso_8601": "2025-01-08T14:50:21.947785Z",
"url": "https://files.pythonhosted.org/packages/0d/a8/e775f29e021024b0c97ffe7b4dc443e6b47420416f08c97d2a8cb7e74d2a/cylc_flow-8.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-08 14:50:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cylc",
"github_project": "cylc-flow",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "cylc-flow"
}
JSON
