#tui #apache #airflow #dag #terminal #applications #flowrs

app flowrs-tui

Flowrs is a Terminal User Interface (TUI) for Apache Airflow

5 releases

new 0.1.4 Nov 29, 2024
0.1.3 Nov 17, 2024
0.1.2 Nov 17, 2024
0.1.1 Nov 16, 2024
0.1.0 Nov 16, 2024

#48 in HTTP server

Download history 167/week @ 2024-11-11 71/week @ 2024-11-18 128/week @ 2024-11-25

366 downloads per month

MIT license

165KB
4K SLoC

flowrs_logo

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.

flowrs demo

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:

flowrs config add demo

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.

Dependencies

~24–39MB
~599K SLoC