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
366 downloads per month
165KB
4K
SLoC
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.
Dependencies
~24–39MB
~599K SLoC