Apprise Python (Core) Library

The Apprise library allows you to send notifications to almost all of the most popular notification services available today (Telegram, Discord, Slack, Email, etc.) using a single, unified Python API.

The library is the engine underneath everything else: the CLI, the API server, and the mobile app all send through it.

For common helpers used across plugins, see the Utilities Reference.

Installation

Apprise is available on PyPI and can be installed via pip.

pip install apprise

If your project uses uv:

uv add apprise

Hello World

The core of the library is the Apprise object. You instantiate it, add URLs, and trigger notifications.

import apprise

# 1. Instantiate the Apprise Object
apobj = apprise.Apprise()

# 2. Add one or more service URLs
apobj.add('mailto://myuser:mypass@hotmail.com')
apobj.add('tgram://123456789:ABCDefghIJKLmnOPqrstUVwxyz')

# 3. Send a notification to all added services
apobj.notify(
    body='What a great notification service!',
    title='My Notification Title',
)