---
id: pypresence
version: "4.6.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# pypresence — Discord RPC client written in Python

License: permissive · Maintenance: active · Downloads: 176.2K/mo

## What it is and what it does

Pypresence is a Discord Rich Presence client library that lets you programmatically update what appears in your Discord profile status. It wraps Discord's RPC API, allowing Python applications to display custom activity information—such as game state, elapsed time, or application details—directly in Discord's UI.

The package is designed for developers who want to integrate Discord presence updates into their applications or games. It requires Python 3.9 or above and has no external runtime dependencies, making it straightforward to add to existing projects. The library supports modern Python versions through 3.13 and is typed for better IDE support.

Use it for:

- Display game state and progress in Discord while playing, showing elapsed time and current activity
- Update your Discord status from a custom application to show what you're currently working on
- Integrate Discord presence into a bot or automation script to reflect its operational state
- Show music playback information in Discord from a Python music player or streaming application

## Worth the install?

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

Pypresence is a Python client for Discord Rich Presence, allowing you to update your Discord profile status with custom activity information from your Python application.

Yes. Pypresence is a stable, actively maintained library with no dependencies, a permissive MIT license, and no known vulnerabilities. Install it if you need to update Discord Rich Presence from a Python application. The only prerequisite is Python 3.9+ and a Discord application token for anything beyond basic rich presence updates.

## Install

pip install pypresence
uv add pypresence
poetry add pypresence

## Installing pypresence

Before you install: Low install friction with no runtime dependencies. The package is actively maintained with a recent release 37 days ago, and the repository shows consistent activity. Supports current Python versions from 3.9 onward.

License in practice: Licensed under MIT, a permissive license that allows free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install pypresence

from pypresence import Presence

client_id = 'YOUR_CLIENT_ID'
Presence(client_id).connect()
Presence(client_id).update(state='Playing', details='Example')

Requires a Discord application ID and Python 3.9 or above; Discord application must be authorized for RPC use.

Verify before relying:

- Whether the package requires Discord application credentials or OAuth setup beyond what the description mentions
- Whether asyncio support is built-in or optional, given the AsyncIO framework classifier

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 176.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

discord rich presence python, discord rpc client, discord activity status, discord presence api, python discord integration, discord game status, discord profile update, discord-integration, rpc-client

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