caronc

apprise: Send Notifications Across Many Services

Apprise is a Python library and CLI for sending alerts through a shared interface to a wide range of notification services. It suits developers and administrators who want one integration for apps, scripts, and infrastructure.

PythonBSD-2-ClauseLibraryCLINotifications
View on GitHub Compare
Stars
17.5k
Forks
672
Stars, last 30 days
+179

Our take

Health score

61/100

How it is scored
Activity
65
Community
61
Issues
60
Pull requests
59

+179 stars in the last 30 days

  • Merges more pull requests than 83% of the projects we track
  • More contributors than 78% of the projects we track

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

17,780

Forks

701

Change since Nov 16, 2026: +6 stars·0 forks

Overview

Apprise provides a common interface for sending notifications to many third-party and self-hosted services. Instead of implementing a separate integration for each destination, applications and scripts can use service URLs through the Python library or the apprise command-line tool.

It is useful when notifications need to reach different platforms, or when a team wants to manage destinations in configuration files and route messages by tags. The project also supports attachments and custom notification hooks. See the official documentation and supported services for details.

Key Features

  • Send notifications through a shared Python API or CLI.
  • Configure destinations using service-specific URLs.
  • Connect to a broad range of notification, SMS, email, desktop, and custom HTTP services.
  • Load YAML or text configuration files, including remote configuration sources.
  • Organize destinations with tags and target selected groups.
  • Include local or remote file attachments where the destination supports them.
  • Extend the tool with custom notification hooks.

Use Cases

  • Developers can add notifications to applications without writing a separate client for each supported service.
  • System administrators can send alerts from shell scripts and scheduled tasks using the CLI.
  • DevOps teams can route operational alerts to different services or groups using configuration files and tags.
  • Teams can use one notification workflow across chat, email, SMS, and push destinations, subject to each service's capabilities.

Getting Started

Install from PyPI:

pip install apprise

For usage examples, configuration options, and supported service URLs, see the README and official documentation.

Alternatives

  • ntfy: ntfy is a specific HTTP-based publish-subscribe service, while Apprise sends alerts through a shared interface to many notification services.
  • Mailroom: Mailroom is a Go framework for routing application events to notification transports, while Apprise is a Python library and CLI for sending alerts.
ProjectLanguageLicenseStarsStatus
apprisePythonBSD-2-Clause17.5kNot checked yet
ntfyGoApache-2.034.6kActive
mailroomGoApache-2.0576Quiet

Considerations

  • Service coverage does not guarantee identical capabilities across destinations. Attachments and message behavior depend on the receiving service.
  • Sending messages requires valid credentials and configuration for the selected services. Treat service URLs and configuration files as sensitive when they contain secrets.
  • The repository describes asynchronous message sending, but delivery still depends on the availability and limits of external services.
  • Apprise is licensed under BSD-2-Clause. Review that license and the terms of any notification providers you use.

Found this useful?

Share it with someone who would like apprise.

Comparisons