Skip to main content

A python package for creating Twitch Bots

Project description


Python Version PyPI version

This framework is a simple wrapper for creating Twitch bots using Python. The Jarvis chatbot for twitch and discord has been built using the J-Core framework for it's Twitch components.

A full set of documentation is still being developed, however, a getting started guide is outlined below.

Getting started


To get started creating a bot using the J-Core framwork is pretty simple, but it does require that you have Python installed on your computer.
Some operating systems come with python pre-installed (e.g. MacOS and most Linux systems), but if you're on Windows, you will need to download Python first to create a bot.
Once you have installed Python, you can use pip to install the J-Core framework and start creating your first bot.


To install the J-Core framework using pip: pip install jcore

To install using this repository:

  1. clone the directory using git clone
  2. navigate into the directory and use pip install

Creating a Simple Bot

To create a simple bot, start by creating a new python file called and copy the code below into the file.

import asyncio
import jcore
from jcore.message import CommandMessage

class SimpleBot(jcore.Client):

    async def on_command(self, message: CommandMessage):
        if message.KEYWORD == "hi":
            await message.send(f"hello {message.display_name}")

if __name__ == "__main__":
    client = SimpleBot()
    loop = asyncio.get_event_loop()

Next, create a file called config.json and copy the following snippet into the file.

    "nick": "<nick>",
    "token": "<token>",
    "channels": [


  • <nick> with the username of your bot account.
  • <token> with the oauth token for your bot. Refer to the Twitch Documentation - Getting Tokens for more information about generating an oauth token.
  • <channel> with the channels you want to connect to.

Once all the values have been set, you can start your bot using:




Adding Logging

If you need to view the logging output of from the framework for your bot, you can configure logging by adding the logging import to the top of your file:

import asyncio
import jcore
from jcore.message import CommandMessage
import logging

Then update the main section of your code to the following:

if __name__ == "__main__":
    logging.basicConfig(level=logging.INFO, format='%(asctime)s [%(levelname)s] %(name)s: %(message)s')

    client = SimpleBot()
    loop = asyncio.get_event_loop()

For more information on using the logging library, refer to the python logging documentation.


These examples above and more can be found in the examples folder.


If you require any further support, please join the discord and seek help from the commuity.

Project details

Download files

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

Source Distribution

jcore- (32.7 kB view hashes)

Uploaded Source

Built Distribution

jcore- (34.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page