An open API service indexing awesome lists of open source software.

https://github.com/seqeralabs/node-red-seqera

Seqera Platform automation on Node-RED
https://github.com/seqeralabs/node-red-seqera

automation bioinformatics nextflow node-red seqera workflow

Last synced: 4 months ago
JSON representation

Seqera Platform automation on Node-RED

Awesome Lists containing this project

README

          



@seqera/node-red-seqera

**A set of Node-RED nodes for interacting with Seqera Platform.**

- πŸ“š Documentation: [https://seqeralabs.github.io/node-red-seqera/](https://seqeralabs.github.io/node-red-seqera/)
- Node-RED icon Node-RED Flows library: [@seqera/node-red-seqera](https://flows.nodered.org/node/@seqera/node-red-seqera)
- npm icon npm package: [@seqera/node-red-seqera](https://www.npmjs.com/package/@seqera/node-red-seqera)
- npm icon Seqera Platform: [https://seqera.io/platform/](https://seqera.io/platform/)

> [!IMPORTANT]
> This project is currently in preview and is not covered by Seqera support. Please submit any problems or feature requests as [GitHub issues](https://github.com/seqeralabs/node-red-seqera/issues).

Gives new Node-RED node types for your automation workflows, which are designed to work together:

@seqera/node-red-seqera nodes

- [Launch a workflow](https://seqeralabs.github.io/node-red-seqera/seqera_nodes/launch_workflow/)
- [Monitor a workflow](https://seqeralabs.github.io/node-red-seqera/seqera_nodes/monitor_workflow/)
- [Poll Workflows](https://seqeralabs.github.io/node-red-seqera/seqera_nodes/poll_workflows/)
- [Add Dataset](https://seqeralabs.github.io/node-red-seqera/seqera_nodes/add_dataset/)
- [List Files from Data Explorer](https://seqeralabs.github.io/node-red-seqera/seqera_nodes/list_files/)
- [Poll Data Link Files](https://seqeralabs.github.io/node-red-seqera/seqera_nodes/poll_files/)
- [Add a Seqera Studio](https://seqeralabs.github.io/node-red-seqera/seqera_nodes/add_studio/)
- [Monitor a Seqera Studio](https://seqeralabs.github.io/node-red-seqera/seqera_nodes/monitor_studio/)

# Typical Use cases

- πŸ› οΈ Integration with events _coming from_ and _going to_ third-party services (AWS, Slack, and [>5000 others](https://flows.nodered.org/search?type=node) supported by Node-RED)
- 🎨 Link triggers and actions to build automation logic using a graphical builder
- πŸ”— Chain workflows, launching downstream automatically
- πŸͺ© (Bonus) Use with [Home Assistant](https://community.home-assistant.io/t/home-assistant-community-add-on-node-red/55023) to make your office go into disco mode when a pipeline completes πŸ•ΊπŸ» πŸŽ‰

## Examples

This package includes several example flows which you can import and repurpose:

- πŸ’‘ **Simple launch & monitor**
- Chan your first workflow Launch and Monitor nodes
- πŸ“‚ **Launch on file upload**
- Launch a pipeline run when new files are detected using Data Link polling
- ♻️ **Auto-resume on workflow failure**
- Automatically resume failed workflows to recover from transient errors
- πŸ”— **Pipeline chaining**
- Chain nf-core/rnaseq and nf-core/differentialabundance pipelines together
- πŸ› πŸ‘©πŸ»β€πŸ’» **Studio on pipeline fail + Slack webhook**
- Create a debugging Studio and send Slack notifications on workflow failure

![pipeline chaining](docs/img/example_flow_04.png)

Use via the Node-RED menu under _Import_ > _Examples_ > _@seqera/node-red-seqera_.
See the [example docs](https://seqeralabs.github.io/node-red-seqera/examples/) for more information.

## Video tutorials

Prefer video to text? Check out the [YouTube Playlist of tutorial videos](https://youtube.com/playlist?list=PL_mgzF8qwHud1pOSurWKO8eDJIqE-_NHi&si=StMNRsyMa9JOjBa8), taking you through installation, Node-RED fundamentals and the different examples!

[![YouTube tutorial playlist](docs/img/youtube-tutorials-introduction.png)](https://youtube.com/playlist?list=PL_mgzF8qwHud1pOSurWKO8eDJIqE-_NHi&si=StMNRsyMa9JOjBa8)

# Quick start

> [!NOTE]
> For more information, please read the [installation docs](https://seqeralabs.github.io/node-red-seqera/installation)

## Seqera Studios

The fastest way to get started is by using [Seqera Studios](https://seqera.io/platform/studios/).

Add a new Studio with the _Template_ set to _Prebuilt container image_ and enter:

```
ghcr.io/seqeralabs/node-red-seqera-studios:latest
```

Make sure that the studio is set to _Always keep the session running_.

Your new Studio should launch with a complete Node-RED instance that's ready for you to customise and use with Seqera automation.

## Within Node-RED

Alternatively Node-RED can be installed just about anywhere. Once installed, grab the Seqera nodes by going to _File_ > _Manage Palette_, then the _Install_ tab.

Search for `@seqera/node-red-seqera` (or just "seqera") and you should find this package. Click _Install_ and the nodes will be available.

# Contributing

Contributions are welcome! If you'd like to contribute to this project, please see [CONTRIBUTING.md](CONTRIBUTING.md).

# License

Apache-2.0 license