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 install flowrs
or with uv on macOS (Apple silicon and Intel) and Linux x86_64:
uv tool install flowrs
You can also download 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
Managed Airflow services
The easiest way to user flowrs is with a managed Airflow service. The currently supported managed services are:
- Conveyor
- Amazon Managed Workflows for Apache Airflow (MWAA)
- Google Cloud Composer
- Astronomer
To enable a managed service, run flowrs config enable -m <service>. This will add the configuration for the managed service to your configuration file, or prompt you for the necessary configuration details. On startup flowrs will then try to find and connect to all available managed service's Airflow instances.
Note that for Astronomer, you need to set the ASTRO_API_TOKEN environment variable with your Astronomer API token (Organization, Workspace or Deployment) to be able to connect to the service.
Custom Airflow instances
If you're self-hosting an Airflow instance, or your favorite managed service is not yet supported, you can register an Airflow server instance with the flowrs config add command:
This creates an entry in your configuration file at $XDG_CONFIG_HOME/flowrs/config.toml (following the XDG Base Directory Specification, which defaults to ~/.config/flowrs/config.toml). For backwards compatibility, flowrs also reads from ~/.flowrs if the XDG location doesn't exist. If you have multiple Airflow servers configured, you can easily switch between them in flowrs configuration screen.
Flowrs supports authenticating with HTTP Basic Auth or using bearer tokens. When selecting the bearer token option, you can either provide a static token or a command that generates a token.
Themes
Flowrs ships with six themes, including four Catppuccin flavors. The active theme is configured with flowrs config --theme <theme>:
| Theme | Description |
|---|---|
auto |
Detects your terminal background and picks dark or light (default) |
dark |
Dark theme |
light |
Light theme |
catppuccin-latte |
Catppuccin Latte (light) |
catppuccin-frappe |
Catppuccin Frappé (medium-dark) |
catppuccin-macchiato |
Catppuccin Macchiato (dark) |
catppuccin-mocha |
Catppuccin Mocha (darkest) |
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file flowrs-0.15.1.tar.gz.
File metadata
- Download URL: flowrs-0.15.1.tar.gz
- Upload date:
- Size: 329.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
299c506461504d590c438df8d9407ec41b647c877bf9d7beaef0be7127a0c758
|
|
| MD5 |
324952182467ccbfaa8c89da444ff50a
|
|
| BLAKE2b-256 |
551736e0f20b366f2dc3831186df1b8f39bae893918330703ba557a2857bced8
|
File details
Details for the file flowrs-0.15.1-py3-none-manylinux_2_28_x86_64.whl.
File metadata
- Download URL: flowrs-0.15.1-py3-none-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 5.5 MB
- Tags: Python 3, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
70eb8e99329c65edc063d604ea51097270680d3cbc5014ee4a28106fa1bff9dd
|
|
| MD5 |
3594fb5218963863e300c98064351883
|
|
| BLAKE2b-256 |
9a99fc80a4e1eaf42464c46fc55c394c890069478c0f0a0075154f2733a51c35
|
File details
Details for the file flowrs-0.15.1-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: flowrs-0.15.1-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 4.7 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
06ce62c47adc759f21772a05c8dd75a752a5f1777fb87d2cc139aa69ae719ea3
|
|
| MD5 |
f7e29fd737a53c6cbfd1c813a3880e80
|
|
| BLAKE2b-256 |
2b2ff58b86c65f4dc97831bfc0a88e303b0b9cefaef75ccc922da42e6c6fcf8a
|
File details
Details for the file flowrs-0.15.1-py3-none-macosx_10_12_x86_64.whl.
File metadata
- Download URL: flowrs-0.15.1-py3-none-macosx_10_12_x86_64.whl
- Upload date:
- Size: 5.0 MB
- Tags: Python 3, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f6ef0966a3bb8f4d0601cd609818ea1ed67b0d151547a328ffa6330560784822
|
|
| MD5 |
8ea642e78029c656321988ed5cd11b83
|
|
| BLAKE2b-256 |
bd9555959f4a9ff1fb7ab3dae33913f4eba6d7a0af4983473bcc09afe52ec3ac
|
