alterself: Python selfbot library for Discord

alterself gives you everything you need to automate a Discord user account: a command framework with prefix routing, a gateway event bus, a complete REST HTTP client, and a built-in spoofing engine that synthesises a coherent browser fingerprint so your account behaves like a real Chrome client. Install it with a single pip install and have your first selfbot running in minutes.

Quick Start

Get your first selfbot running in under five minutes

Installation

Install alterself and configure your environment

Core Concepts

Understand the Client, commands, events, and cogs

API Reference

Explore the full HTTP method and model reference

What you can build

Command Bots

Build prefix-based command bots that respond to your own messages with argument parsing and checks

Event Automations

React to any Discord gateway event — messages, reactions, guild changes, presence updates, and more

Presence Cycling

Set custom statuses, fake Spotify playback, cycle activities, and control your online/idle/DND state

Get started in three steps

Install alterself

pip install alterself

Create your client

app.py

import alterself

bot = alterself.Client(token="YOUR_USER_TOKEN", prefix=".")

@bot.on_event
async def on_ready():
    print(f"Ready as {bot.me.username}")

@bot.command()
async def ping(ctx):
    await ctx.reply(f"pong | {bot.latency * 1000:.1f} ms")

Run it

python app.py

Never share your Discord token. Treat it like a password — anyone with your token has full access to your account.

⌘I

Get Started

Core Concepts

Guides

alterself: Python selfbot library for Discord

Quick Start

Installation

Core Concepts

API Reference

What you can build

Command Bots

Event Automations

Presence Cycling

Get started in three steps

Quick Start

Installation

Core Concepts

API Reference

​What you can build

Command Bots

Event Automations

Presence Cycling

​Get started in three steps

What you can build

Get started in three steps