cylc-flow

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 | Documentation

# install cylc
conda install cylc-flow

# extract an example to run
cylc get-resources examples/2-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 - The core Cylc Scheduler for defining and running workflows.
cylc-uiserver - The web-based Cylc graphical user interface for monitoring and controlling workflows.
cylc-rose - Provides integration with Rose.

Migrating From Cylc 7

Migration Guide | Migration Support

Cylc 8 can run most Cylc 7 workflows in compatibility mode with little to no changes, go through the migration guide 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

Copyright and Terms of Use

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.

Contributing

Contributions welcome:

Read the contributing page.
Development setup instructions are in the developer docs.
Involved change proposals can be found in the admin pages.
Touch base in the developers chat.

This repository contains some code that was generated by GitHub Copilot.

Metadata

Release files for cylc-flow 8.6.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cylc-flow 8.6.7
File	Size	Uploaded
cylc_flow-8.6.7.tar.gz	867.2 kB	Oct 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cylc-flow 8.6.7
File	Interpreter	ABI	Platform	Reset
cylc_flow-8.6.7-py3-none-any.whl 1.1 MB Oct 9, 2026	Python 3	none	any	Details

Total release size: 2.0 MB

Release files / cylc_flow-8.6.7.tar.gz

Download URL	cylc_flow-8.6.7.tar.gz
Size	867.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`7e81279ea7af2cbe2771b61b5e7f61d78f224176e14da061a76dd4be78d7a21a`
BLAKE2b-256 checksum How to use checksums	`19f1ac0daf3beafba2c810e84d1b6e7e18e256719187cce11e047373c3f89722`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / cylc_flow-8.6.7-py3-none-any.whl

Download URL	cylc_flow-8.6.7-py3-none-any.whl
Size	1.1 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`63adf3927c2329a52d7b2d16cb78a44e7d6e7e8c4e68ebde33d55620446522bb`
BLAKE2b-256 checksum How to use checksums	`45e0c5363f71f45b6babf1022d43eb6e5bdd299da44b3a9cd7d74f85c186dc46`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`