---
id: pysher
version: "1.0.8"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# Pysher — Pusher websocket client for python, based on Erik Kulyk's PythonPusherClient

License: permissive · Maintenance: abandoned · Downloads: 1.3M/mo

## What it is and what it does

Pysher is a WebSocket client for the Pusher real-time messaging service. It lets you subscribe to Pusher channels from Python and bind event handlers to react to incoming messages in real time. The library manages the WebSocket connection, handles reconnection, and automatically resubscribes to channels after disconnects.

The package is a fork of an earlier PythonPusherClient, updated to drop support for Python versions before 3.5. It is currently in maintenance mode—the original author no longer actively develops it, but the repository accepts pull requests for fixes and features. High install friction and abandonment status mean you should verify compatibility with your environment before adopting it.

Use it for:

- Build a real-time chat or notification system that receives messages pushed from a Pusher backend.
- Monitor live events or status updates from a server without polling.
- Subscribe to multiple channels and react to different event types with custom handlers.
- Integrate Pusher real-time capabilities into a Python application or service.
- Consume WebSocket events in a background worker or daemon process.

## Worth the install?

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

Pysher is a Python client library for consuming Pusher WebSocket events, allowing you to subscribe to channels and bind event handlers to receive real-time messages.

Yes, if you are already committed to Pusher as your real-time messaging platform and need a Python WebSocket consumer. The MIT license is permissive, and there are no known vulnerabilities. However, proceed with caution: the package is abandoned, install friction is high, and compatibility with modern Python versions is unverified. Test thoroughly in your environment and consider whether an actively maintained alternative exists before committing to production use.

## Install

pip install pysher
uv add pysher
poetry add pysher

## Installing Pysher

Before you install: Installation requires websocket-client as a dependency. The package is in maintenance mode with no active development since August 2023, though the repository remains public and accepts PRs. High install friction suggests potential setup complexity.

License in practice: MIT license is permissive, allowing commercial and private use with minimal restrictions—you need only include a copy of the license in distributions.

Quickstart:

pip install pysher

import pysher
pusher = pysher.Pusher(appkey='your-app-key')
channel = pusher.subscribe('mychannel')
channel.bind('myevent', lambda data: print(data))
pusher.connect()

Requires websocket-client module; connection requires a valid Pusher app key and network access to Pusher servers.

Verify before relying:

- Whether websocket-client dependency is automatically installed or must be manually added.
- Current compatibility with Python versions beyond 3.7 (classifiers list 3.5–3.7).
- Whether wsaccel optimization for UTF-8 validation is still relevant or recommended.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 1.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pusher websocket client, real-time event subscription, websocket event handler, pusher channel binding, python websocket consumer, pusher client library, real-time messaging python, websocket-client, real-time-messaging, pusher-integration

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