Skip to main content

discord_self is a fork of discord.py-self that lives under the discord_self namespace in order to allow both selfbots and bots to run together.

discord.py-self

Telegram chat PyPI version info PyPI supported Python versions PyPI downloads per month

A modern, easy-to-use, feature-rich, and async-ready API wrapper for Discord’s user API written in Python.

Note:
Automating user accounts is against the Discord ToS. This library is a proof of concept and I cannot recommend using it. Do so at your own risk.

Credits:
  • Rapptz for the original library this fork is based on. Without it, the project would not exist.

  • arandomnewaccount for help when the project was first started.

Key Features

  • Modern Pythonic API using async and await.

  • Proper rate limit handling.

  • Optimised in both speed and memory.

  • Mostly compatible with the upstream discord.py.

  • Prevents user account automation detection.

  • Implements vast amounts of the user account-specific API. For a non-exhaustive list:

    • Sessions

    • Read states

    • Connections

    • Relationships

    • Experiments

    • Protobuf user settings

    • Application/team management

    • Store/SKUs/entitlements

    • Billing (e.g. subscriptions, payments, boosts, promotions, etc.)

    • Interactions (slash commands, buttons, etc.)

Installing

Python 3.10 or higher is required.

To install the library without full voice support, you can just run the following command:

# Linux/macOS
python3 -m pip install -U discord.py-self

# Windows
py -3 -m pip install -U discord.py-self

Otherwise to get voice support you should run the following command:

# Linux/macOS
python3 -m pip install -U "discord.py-self[voice]"

# Windows
py -3 -m pip install -U discord.py-self[voice]

To install the development version, do the following:

$ git clone https://github.com/dolfies/discord.py-self
$ cd discord.py-self
$ python3 -m pip install -U .[voice]

Optional Packages

Please note that on Linux installing voice you must install the following packages via your favourite package manager (e.g. apt, dnf, etc) before running the above commands:

  • libffi-dev (or libffi-devel on some systems)

  • python-dev (e.g. python3.6-dev for Python 3.6)

Using with Upstream

If you would like to use the library alongside upstream discord.py, you can install selfcord.py instead of discord.py-self. Check out the renamed branch for more information.

Quick Example

import discord

class MyClient(discord.Client):
    async def on_ready(self):
        print('Logged on as', self.user)

    async def on_message(self, message):
        # only respond to ourselves
        if message.author != self.user:
            return

        if message.content == 'ping':
            await message.channel.send('pong')

client = MyClient()
client.run('token')

Bot Example

import discord
from discord.ext import commands

bot = commands.Bot(command_prefix='>', self_bot=True)

@bot.command()
async def ping(ctx):
    await ctx.send('pong')

bot.run('token')

You can find more examples in the examples directory.

Metadata

Release files for discord-self 2.1.0.post1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for discord-self 2.1.0.post1
File Size Uploaded Provenance Actions
discord_self-2.1.0.post1.tar.gz 622.4 kB With provenance Details for discord_self-2.1.0.post1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for discord-self 2.1.0.post1
File Interpreter ABI Platform Actions
discord_self-2.1.0.post1-py3-none-any.whl Python 3 none any Details for discord_self-2.1.0.post1-py3-none-any.whl

Total release size: 1.4 MB

Release files / discord_self-2.1.0.post1.tar.gz

Download URL discord_self-2.1.0.post1.tar.gz
Size 622.4 kB
Tags Source
SHA-256 checksum
How to use checksums
3d5bafb7bce22f7ff9efaafc55bc2f66648dabd66dde9abc8c799134fea65a36
BLAKE2b-256 checksum
How to use checksums
eba11d27f980632574d715ecd49deb19bdb0d0c5fcae14016e4ce4c4bb4a7350
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 1, 2026.

Transparency log

Release files / discord_self-2.1.0.post1-py3-none-any.whl

Download URL discord_self-2.1.0.post1-py3-none-any.whl
Size 774.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7897a20b2069e0e6301333455747e6a93b6ed7d671e9e3998fc1c8f8528e21d3
BLAKE2b-256 checksum
How to use checksums
f859dcd096b705ae322726e23a5d1f3b8b3d38663698921c59d5207144a60a1d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 1, 2026.

Transparency log

Security for discord-self 2.1.0.post1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for discord_self-2.1.0.post1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 1, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page