harambot 0.3.3

A Yahoo Fantasy Sports bot for Discord

Harambot

An interactive Yahoo Fantasy sports bot for Discord.

Commands

/ping                           - Gives the latency of harambot
/RIP                            - Pay respects
/standings                      - Returns the current standings of the current league
/roster "Team name"             - Returns the roster of the given team
/stats "Player Name"            - Returns the details of the given player
/trade                          - Create poll for latest trade for league approval
/matchups                       - Returns the current weeks matchups
/waiver                         - Returns the waiver wire tranasactions from the previous 24 hours
/configure                      - Configure the bot for your guild

You can find example output of these commands here

Roll your own instance

Prerequisites

In order to properly configure your bot you will need the following:

• Discord API Token
• Yahoo API Client Id & Secret
• Yahoo League ID

Visit our wiki for a step by step guide on how to obtain these values.

Run the bot in the cloud

Run the bot locally using pip package

1. Install the harambot package using pip

    pip install harambot
   

2. Export the following environment variables

   export DISCORD_TOKEN='[YOUR DISCORD TOKEN]'
   export YAHOO_KEY='[YOUR YAHOO API CLIENT ID]'
   export YAHOO_SECRET='[YOUR YAHOO API CLIENT SECRET]'
   export DATABASE_URL='[YOUR DATABASE URL]'
   

3. Run the bot

    harambot
   

Run the bot locally using docker

1. Pull the latest image from docker hub

    docker pull dmcp89/harambot
   

2. Export the following environment variables

   export DISCORD_TOKEN='[YOUR DISCORD TOKEN]'
   export YAHOO_KEY='[YOUR YAHOO API CLIENT ID]'
   export YAHOO_SECRET='[YOUR YAHOO API CLIENT SECRET]'
   export DATABASE_URL='[YOUR DATABASE URL]'
   

3. Run the bot

    docker run --name harambot \
    -e DISCORD_TOKEN=$DISCORD_TOKEN \
    -e YAHOO_KEY=$YAHOO_KEY \
    -e YAHOO_SECRET=$YAHOO_SECRET \
    -e DATABASE_URL=$DATABASE_URL \
    --rm dmcp89/harambot
   

Setup

Add the bot to your guild

1. Generate a OAuth url from the discord developer portal using the bot scope and the following permissions:

• Send Messages
• Send Messages in Threads
• Embed Links
• Attach Files
• Read Message History
• Add Reactions
• Use Slash Commands

The permission value should be 277025507392

2. Set the gateway intents

In order for the bot to work properly it requires the following intents:

• Sever Members Intent
• Message Content Intent

3. Navigate to the generated url in a web browser and authorize the bot for your guild

Configure your guild

• Once your bot is added to your guild you can configure it by using the /configure command:

• Use the Login with Yahoo button to authenticate with Yahoo and get your Yahoo token

• Use the Configure Guild button to configure your guild for the bot

• You can reconfigure your guild by running the configure command and clicking the Configure Guild button.