whatisgithub

What is apprise?

liushuyu/apprise — explained in plain English

Analysis updated 2026-07-08 · repo last pushed 2024-04-11

Audience · ops devopsComplexity · 2/5DormantSetup · easy

In one sentence

Send push notifications to almost any messaging service, Slack, Discord, Telegram, email, SMS, and more, from a single lightweight tool. Write one message and it delivers everywhere at once.

Mindmap

mindmap
  root((repo))
    What it does
      Send to 50+ services
      Async delivery
      Attachments supported
    Tech stack
      Python
      Command-line tool
      Config files
    Use cases
      App notifications
      Server alerts
      Deployment updates
    Audience
      Developers
      DevOps admins
    Features
      Simple URL config
      Desktop notifications
      Custom hooks
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add multi-platform notifications to your app without integrating each service separately.

USE CASE 2

Send server downtime or deployment alerts to Slack, Telegram, or Discord from a script.

USE CASE 3

Broadcast a single message to dozens of messaging services at the same time.

What is it built with?

PythonCLI

How does it compare?

liushuyu/apprise0xhassaan/nn-from-scratch0xzgbot/hermes-comfyui-skills
Stars00
LanguagePython
Last pushed2024-04-11
MaintenanceDormant
Setup difficultyeasymoderateeasy
Complexity2/54/51/5
Audienceops devopsdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires you to provide your own credentials like webhook URLs or bot tokens for each service.

So what is it?

Apprise lets you send push notifications to almost any messaging service, Telegram, Discord, Slack, email, SMS, and dozens more, all from a single tool. Instead of writing separate code or finding a separate tool for each platform you want to notify, you write one notification once and Apprise handles delivering it everywhere. The way it works is straightforward. You tell Apprise which services to send to using simple URLs that contain your credentials for each platform, for example, a Discord webhook URL or a Telegram bot token. Then you give it a message, and it fires it off to all of those services at once. Messages go out asynchronously, meaning it doesn't wait for one service to finish before starting on the next, which keeps things fast. It can also handle images and file attachments for services that support them. This is built for two main audiences. Developers who want to add notifications to their app no longer need to research and integrate a dozen different APIs, they add one library and get access to nearly every notification service out there. System administrators and DevOps folks can use the command-line tool to send alerts when servers go down, deployments finish, or anything else needs attention, without hunting for the right tool for each platform. A few things stand out. The project supports an enormous list of services, well over 50 at this point, covering productivity apps, SMS, email, desktop notifications, and custom hooks. You can also use configuration files to define your notification targets once and reuse them, so you're not repeating setup every time. It's written in Python and designed to be lightweight. The main tradeoff is that you're relying on a single library to keep up with every notification service's API, which changes over time. But that's also the point, instead of you tracking those changes across dozens of services, the project does it for you.

Copy-paste prompts

Prompt 1
Using Python Apprise, write a script that sends 'Build succeeded!' to a Discord webhook and a Telegram bot at the same time.
Prompt 2
Write a bash script using the Apprise CLI to send a server alert message to multiple notification services defined in a config file.
Prompt 3
Using Apprise in Python, attach an image file to a notification sent to a Discord webhook URL.
Prompt 4
Create an Apprise config file that defines notification targets for Slack, Telegram, and email, then send a test message to all of them.

Frequently asked questions

What is apprise?

Send push notifications to almost any messaging service, Slack, Discord, Telegram, email, SMS, and more, from a single lightweight tool. Write one message and it delivers everywhere at once.

Is apprise actively maintained?

Dormant — no commits in 2+ years (last push 2024-04-11).

How hard is apprise to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is apprise for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.