Apprise
Apprise is a lightweight notification library and command-line tool that lets you send messages to over 100 popular notification services like Telegram, Discord, Slack, and more using a single, unified URL syntax. It solves the problem of integrating with multiple notification APIs by providing one consistent interface, making it ideal for developers and system administrators who need to send alerts or notifications from their applications or scripts.
✨ Key features
- One notification library to rule them all.
- Common and intuitive notification syntax.
- Supports handling of images and attachments.
- Incredibly lightweight and asynchronous.
- Includes a command-line tool (CLI) for easy use.
- Supports configuration files and environment variables.
🎯 Use cases
- Send alerts from monitoring scripts or cron jobs.
- Notify users of events in web applications.
- Integrate notifications into DevOps pipelines.
- Send messages to multiple services simultaneously.
- Build custom notification hooks for internal tools.
📦 Installation
🧰 Requirements: Python 3.6+ (or use the CLI), no API keys required for the library itself, but each notification service requires its own credentials or tokens.
pip install apprisepip install git+https://github.com/caronc/apprise.git🚀 Usage
import apprise
# Create an Apprise instance
apobj = apprise.Apprise()
# Add a notification service (e.g., Discord)
apobj.add('discord://webhook_id/webhook_token')
# Send a notification
apobj.notify(body='Hello World!')
❓ FAQ
What notification services does Apprise support?
Apprise supports over 100 services including Discord, Telegram, Slack, Amazon SNS, Gotify, and many more. A full list is available in the README and on the official documentation site.
How do I send a notification using Apprise?
You can use the Python API by creating an Apprise object, adding a service URL, and calling notify(). Alternatively, use the command-line tool with the apprise command.
Can I send attachments with Apprise?
Yes, Apprise supports handling images and attachments for notification services that accept them. You can attach files via the CLI or API.
Is Apprise lightweight and fast?
Yes, Apprise is described as incredibly lightweight and has amazing response times because all messages are sent asynchronously.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.