Registry / workflow / apache-airflow-providers-apprise

apache-airflow-providers-apprise

library2.3.4pypypiunverified

Apache Airflow provider that integrates with Apprise to send notifications via a wide variety of services (Slack, Telegram, email, etc.). Current version 2.3.3, released March 2025. Supports Airflow >=2.8.0. Patch releases monthly.

workflow communication devops

pip install apache-airflow-providers-apprise

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · APACHE-AIRFLOW-PRO

apache-airflow-providers-apprise

workflowpythonv2.3.4

Install

24.3s avg

Import

—

Disk

261MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.3.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 260.6MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 24.3s · import 0.000s · 258MB

261MB installed

● package 261MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

AppriseWebhookHook

✓ from airflow.providers.apprise.hooks.apprise import AppriseWebhookHook

✗ from airflow.providers.apprise.hooks.apprise import AppriseWebhookHook

Basic usage: define an AppriseWebhookOperator in a DAG. Requires an Airflow connection configured with Apprise URLs.

import os from airflow.providers.apprise.operators.apprise import AppriseWebhookOperator from airflow.models import DAG from datetime import datetime default_args = { 'owner': 'airflow', 'start_date': datetime(2024, 1, 1), } with DAG(dag_id='apprise_example', default_args=default_args, schedule=None, catchup=False): send_notification = AppriseWebhookOperator( task_id='send_notification', apprise_conn_id='apprise_default', message='Hello from Airflow!', title='Test', tag='alert', )

airflow --version

Debug

Known issues

breakingIn provider version 1.x, import paths used `airflow.contrib.hooks.apprise_hook`. This was removed in 2.0. Update imports to `airflow.providers.apprise`.

fix

Use `from airflow.providers.apprise.hooks.apprise import AppriseWebhookHook` instead of old contrib path.

affects: >=2.0.0

gotchaThe Airflow connection must have `conn_type='apprise'` and the host field should contain one or more Apprise URLs separated by newlines. If URLs are not valid, the hook silently fails.

fix

Configure connection via Airflow UI or CLI: `airflow connections add apprise_default --conn-type apprise --conn-host 'slack://token-a/token-b/\njson://localhost/custom'`. Use double newline to separate URLs.

affects: all

gotchaOperator field `apprise_conn_id` defaults to 'apprise_default'. If not set correctly, notifications will not send without error.

fix

Explicitly set `apprise_conn_id` to match the connection ID you created.

affects: all

deprecatedThe `tag` parameter was added in 2.3.0. In older versions, tags were not supported. If you rely on tagging, upgrade to >=2.3.0.

fix

Upgrade package: `pip install apache-airflow-providers-apprise>=2.3.0`

affects: <2.3.0

Upgrade

Version history

2.3.4latest on PyPI · released Jun 7, 2026

Audit

Dependencies

apache-airflowoptionalRequired runtime dependency for provider hooks and operators.

appriserequiredCore notification library; this provider wraps Apprise calls.

Agent activity

33 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/apache/airflow ↗

packagehttps://pypi.org/project/apache-airflow-providers-apprise/ ↗

docshttps://airflow.apache.org/docs/apache-airflow-providers-apprise/2.3.3 ↗

changeloghttps://airflow.apache.org/docs/apache-airflow-providers-apprise/2.3.3/changelog.html ↗