Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

An efficient APNs Client Library for Python/asyncio

Project Description

aioapns is a library designed specifically for sending push-notifications to iOS devices via Apple Push Notification Service. aioapns provides an efficient client through asynchronous HTTP2 protocol for use with Python’s asyncio framework.

aioapns requires Python 3.5 or later.


In my testing aioapns allows you to send on average 1.3k notifications per second on a single core.


  • Internal connection pool which adapts to the current load
  • Ability to set TTL (time to live) for notifications
  • Ability to set priority for notifications
  • Ability to set collapse-key for notifications


Use pip to install:

$ pip install aioapns

Basic Usage

from uuid import uuid4
from aioapns import APNs, NotificationRequest

async def run():
    apns = APNs('/path/to/apns-production-cert.pem')
    request = NotificationRequest(
        message = {
            "aps": {
                "alert": "Hello from APNs",
                "badge": "1",
        notification_id=str(uuid4())  # optional
        time_to_live=3,               # optional
    await apns.send_notification(request)

loop = asyncio.get_event_loop()


aioapns is developed and distributed under the Apache 2.0 license.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
aioapns-1.1.1.tar.gz (6.0 kB) Copy SHA256 Checksum SHA256 Source Jan 19, 2018

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting