Skip to main content

A Python IRC and API wrapper for Twitch.

Project description Maintainability

An Asynchronous IRC/API Wrapper currently in Development for TwitchBots made in Python!


Official Documentation: Click Here!


For support using TwitchIO, please join the official support server on Discord.


The following commands are currently the valid ways of installing TwitchIO.

TwitchIO requires Python 3.6 or higher.


py -version -m pip install twitchio


python3 -m pip install twitchio

Getting Started

TwitchIO uses many endpoints which may require different tokens and IDs.

  1. IRC endpoints which require an OAuth token.
    To get a token, log in to Twitch with the bot’s account and visit:
  2. HTTP endpoints which require a client ID.
    To be documented.
  3. HTTP endpoints which require an OAuth token and certain scopes.
    To be documented.

All 3 endpoints may be used at the same time. Otherwise, you may choose to use any or some of the endpoints.

Currently, TwitchIO’s development is at a phase which has emphasis on the IRC endpoint and creating a framework around it. Once this is implemented, the other 2 endpoints will be developed further.

A quick and easy bot example:

from twitchio.ext import commands

class Bot(commands.Bot):

    def __init__(self):
        super().__init__(irc_token='...', client_id='...', nick='...', prefix='!',

    # Events don't need decorators when subclassed
    async def event_ready(self):
        print(f'Ready | {self.nick}')

    async def event_message(self, message):
        await self.handle_commands(message)

    # Commands use a different decorator
    async def my_command(self, ctx):
        await ctx.send(f'Hello {}!')

bot = Bot()

Become a patron and help support TwitchIO’s development <3.

All Twitch logos used are owned by respectively. Use of the Twitch logos does not imply any affiliation with or endorsement by them.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for twitchio, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size twitchio-1.2.1-py3-none-any.whl (48.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size twitchio-1.2.1.tar.gz (35.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page