Lib.rs

Flowrs is a TUI application for Apache Airflow. It allows you to monitor, inspect and manage Airflow DAGs from the comforts of your terminal. It is build with the ratatui library.

Installation

You can install flowrs via Homebrew if you're on macOS / Linux / WSL2:

brew tap jvanbuel/flowrs
brew install flowrs

or by downloading the binary directly from GitHub:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/jvanbuel/flowrs/releases/latest/download/flowrs-tui-installer.sh | sh

Alternatively, you can build flowrs from source with cargo:

cargo install flowrs-tui --locked

Usage

You can register an Airflow server instance with the flowrs config add command:

This creates an entry in a ~/.flowrs configuration file. If you have multiple Airflow servers configured, you can easily switch between them in flowrs starting screen.

Only basic authentication and bearer token authentication are currently supported. When selecting the bearer token option, you can either provide a static token or a command that generates a token.

Managed services

flowrs supports the following managed services:

• Conveyor
• Google Cloud Composer
• Amazon Managed Workflows for Apache Airflow (MWAA)
• Astronomer

To enable a managed service, add it to the managed_services section in the configuration file, e.g.:

managed_services = ["Conveyor"]

flowrs will then on startup try to find and connect to all the Airflow instances that are managed by the specified service.