jjtech0130/pypush

Analysis updated 2026-07-03

★ 3,732PythonAudience · developerComplexity · 4/5LicenseSetup · hard

Mindmap

mindmap
  root((pypush))
    What it does
      APNs client in Python
      Reverse-engineered APIs
      Push notification receipt
    Status
      Unstable pre-3.0
      iMessage API removed
      Major rewrite ongoing
    Requirements
      Apple device identifiers
      pip install
    Ownership
      Acquired by Beeper
      SSPL license

mindmap root((pypush)) What it does APNs client in Python Reverse-engineered APIs Push notification receipt Status Unstable pre-3.0 iMessage API removed Major rewrite ongoing Requirements Apple device identifiers pip install Ownership Acquired by Beeper SSPL license

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Build a Python application that connects to Apple's APNs push infrastructure and receives notifications without owning an Apple device.

USE CASE 2

Study how Apple's push notification delivery system works under the hood by reading the reverse-engineered pypush APNs client implementation.

USE CASE 3

Prototype a non-Apple device that behaves like an iOS or Mac client on the APNs network for research or integration testing purposes.

What is it built with?

Pythonpip

How does it compare?

	jjtech0130/pypush	ab77/netflix-proxy	crypto101/book
Stars	3,732	3,729	3,729
Language	Python	Python	Python
Setup difficulty	hard	moderate	moderate
Complexity	4/5	3/5	1/5
Audience	developer	ops devops	general

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

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires Apple device identifiers that are difficult to obtain on non-Apple hardware, the library is unstable and undergoing a major rewrite.

Server Side Public License (SSPL): you may use and modify freely, but if you run this code as a service for others you must also open-source all related infrastructure code.

In plain English

pypush is a Python library built on reverse-engineered versions of Apple's internal APIs. It started as a proof-of-concept demonstration of how iMessage works under the hood, and has since expanded into a broader community effort to cover more of Apple's private API surface. The library currently supports the client side of APNs, which is Apple's push notification system. APNs is the infrastructure Apple uses to deliver notifications to iPhones, iPads, and Macs. With pypush, a Python program can register and behave like an Apple device, receiving push notifications through that system. The iMessage API, which was part of the original proof-of-concept, has been temporarily removed while the library undergoes a major rewrite. The README notes that the project is not stable. Versioning starts at 2.0.0 due to a naming conflict, and the authors caution that stability should not be expected until version 3.0.0. Installation is via pip. The library is platform-independent, though some Apple APIs require device identifiers that may be harder to obtain on non-Apple hardware. Beeper, a company that built a multi-protocol messaging client, purchased this project. The license is the Server Side Public License (SSPL), which is a stricter variant of open-source licensing that places conditions on how the software can be used to provide services. For licensing questions, the README directs users to Beeper. The README is short and does not go into further technical detail about planned features or the timeline for the rewrite.

Copy-paste prompts

Prompt 1

How do I install pypush via pip and write a Python script that registers as an APNs client and starts receiving Apple push notifications?

Prompt 2

What Apple device identifiers does pypush need to connect to APNs, and what is the easiest way to obtain them on a Linux machine?

Prompt 3

Walk me through the APNs registration flow that pypush performs, what network calls does it make and what certificates or tokens does it exchange?

Prompt 4

What does pypush's SSPL license mean in practice? Can I use it in a private project or build a commercial product on top of it?

Frequently asked questions

What is pypush?

A Python library built on reverse-engineered Apple APIs that allows a Python program to register as an APNs client and receive Apple push notifications like a real Apple device.

What language is pypush written in?

Mainly Python. The stack also includes Python, pip.

What license does pypush use?

Server Side Public License (SSPL): you may use and modify freely, but if you run this code as a service for others you must also open-source all related infrastructure code.

How hard is pypush to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is pypush for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub jjtech0130 on gitmyhub

Verify against the repo before relying on details.