skillfed

pypresence

Discord RPC client written in Python

pypresence v4.6.2 176.2K downloads/30d#10,251 on PyPI739
Permissive license MIT Active released

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 on this page — 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

pypresence on PyPI

pip

pip install pypresence

uv

uv add pypresence

poetry

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 the current Python release (>=3.9)
Install friction low — pure-Python wheel
Runtime dependencies none
Maintenance actively maintained — 37 days since the last release
Last repo commit
First released
Downloads 176,164/month — #10,251 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: pypresence-4.6.2-py3-none-any.whl

Keywords: discord, rich presence, pypresence, rpc, api, wrapper, gamers, chat, irc

Development Status :: 5 - Production/StableFramework :: AsyncIOIntended Audience :: DevelopersOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonTopic :: Communications :: ChatTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Python ModulesTyping :: Typed

Tags

discord rich presence pythondiscord rpc clientdiscord activity statusdiscord presence apipython discord integrationdiscord game statusdiscord profile update
discord-integrationrpc-client

More Libraries packages