---
id: apns2-up
version: "0.9.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# apns2-up — A python library for interacting with the Apple Push Notification Service via HTTP/2 protocol

License: permissive · Maintenance: aging · Downloads: 103.7K/mo

## What it is and what it does

apns2-up is a Python client library for sending push notifications to iOS devices via Apple's Push Notification service (APNs) over HTTP/2. It abstracts the complexity of APNs protocol handling and credential management, supporting both certificate-based authentication (via .pem files) and token-based authentication (via auth keys). The library depends on hyper-up for HTTP/2 transport, PyJWT for token signing, and cryptography for certificate handling.

The package is designed for server-side applications that need to deliver notifications to iOS apps. It supports single notifications and batch operations, allowing developers to send alerts, sounds, and badge updates. However, the package shows signs of age—last released 455 days ago with minimal repository activity—raising questions about ongoing maintenance and compatibility with current Apple APNs requirements.

Use it for:

- Send alert notifications to iOS users when server-side events occur (e.g., messages, reminders, activity updates).
- Deliver batch notifications to multiple iOS devices in a single operation for efficiency.
- Implement token-based authentication for APNs when certificate management is impractical.
- Build a notification service that manages badge counts and sound preferences per notification.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Sends push notifications to iOS devices through Apple's APNs service using HTTP/2, supporting both certificate-based and token-based authentication.

Yes, with caution. The library is functional and permissively licensed, but its aging status (455 days since last release, minimal repository activity) means you should verify compatibility with current Apple APNs requirements before production use. High install friction from three non-trivial dependencies is acceptable for the problem it solves. Consider checking whether the hyper-up dependency is actively maintained, as it is a critical transport layer.

## Install

pip install apns2-up
uv add apns2-up
poetry add apns2-up

## Installing apns2-up

Before you install: High install friction due to three non-trivial runtime dependencies (hyper-up, PyJWT, cryptography). Package is aging—last release 455 days ago—with minimal repository activity (1 star, last commit 2025-05-16). Maintenance status suggests limited ongoing support.

License in practice: MIT license is permissive and imposes no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

from apns2.client import APNsClient
from apns2.payload import Payload

payload = Payload(alert="Hello World!", sound="default", badge=1)
client = APNsClient('key.pem', use_sandbox=False)
client.send_notification(token_hex, payload, topic='com.example.App')

Requires a valid Apple APNs certificate (key.pem) or token credentials with auth_key_id and team_id from Apple Developer account.

Verify before relying:

- Whether hyper-up is a maintained fork or a stale dependency; standard hyper status unknown.
- Compatibility with current Apple APNs API changes or deprecations since last release.
- Whether token-based auth implementation matches current Apple requirements.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: aging
- Downloads: 103.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

apple push notifications ios, apns http2 client, ios push notification library, send notifications to iphone, apns certificate authentication, token based apns, batch push notifications ios, push-notifications, ios-development, http2

[View on SkillFed](https://skillfed.io/packages/apns2-up) · [View on PyPI](https://pypi.org/project/apns2-up/)