---
id: discord-py-self
version: "2.1.0"
license: The MIT License (MIT) Copyright (c) 2015-present Rapptz Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# discord.py-self — A Python wrapper for the Discord user API

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

## What it is and what it does

discord.py-self is an async Python wrapper for Discord's user account API—the undocumented interface that powers the Discord client itself rather than bot accounts. It extends the original discord.py library with methods to automate user account actions: reading message history, managing relationships, handling billing and subscriptions, responding to interactions, and controlling sessions. The library is intentionally designed to avoid detection by Discord's systems.

The package depends on aiohttp for HTTP requests, curl_cffi for advanced HTTP handling, tzlocal for timezone support, discord_protos for protobuf message definitions, and audioop-lts for audio operations. It targets modern Python (3.10–3.14) and maintains active development. However, the description itself carries an explicit warning: automating user accounts violates Discord's Terms of Service, and the authors cannot recommend its use.

Use it for:

- Build a self-bot that responds to commands in your own Discord messages for personal automation.
- Programmatically manage user account settings, relationships, and billing information.
- Automate message reading and interaction handling for personal Discord workflows.
- Interact with Discord's slash commands and button interactions from a user account.
- Manage multiple user account sessions and read states programmatically.

## Worth the install?

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

An async Python wrapper for Discord's user account API, enabling programmatic control of user accounts with support for sessions, relationships, billing, and interactions.

No. While the library is technically mature and well-maintained, the description explicitly warns that automating user accounts violates Discord's Terms of Service and the authors cannot recommend its use. Installing and running this code exposes you to account suspension or permanent ban. Use only if you fully understand and accept the ToS violation and the risk of account loss.

## Install

pip install discord-py-self
uv add discord-py-self
poetry add discord-py-self

## Installing discord.py-self

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with recent commits and a stable release history since 2021. Requires Python 3.10 or higher.

License in practice: MIT license permits commercial and private use with minimal restrictions; attribution required.

Quickstart:

pip install discord.py-self

import discord

client = discord.Client()
client.run('user_token')

Python 3.10 or higher required. Automating user accounts violates Discord's Terms of Service.

Verify before relying:

- Whether the library successfully evades Discord's automation detection in practice.
- Current status of Discord's enforcement against user account automation and whether this library remains functional.
- Whether all user-account-specific API features (billing, experiments, protobuf settings) are fully implemented and stable.

## Package facts

- License: The MIT License (MIT) Copyright (c) 2015-present Rapptz Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 115.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

discord user account api wrapper, discord self bot library, discord user automation python, async discord client, discord user api python, discord-api, self-bot, user-automation

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