dmcp89/harambot repository overview

⁠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                    - Returns the roster of the given team
/stats Player                   - Returns the details of the given player
/trade                          - Create a poll for latest trade for league approval
/matchups week                  - Returns the matchups for the given week, defaults to the current week
/waiver days                    - Returns the waiver wire transactions from the previous number of days
/configure                      - Configure the bot for your guild
/reports                        - Set what channel transaction reports should be sent to.

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 on Render⁠

⁠Run the bot locally using pip package

1. Install the harambot package using pip

    pip install harambot
   

   Copy

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]'
   export HARAMBOT_KEY='[YOUR ENCRYPTION KEY]' # A URL-safe base64-encoded 32-byte key
   

   Copy

3. Run the bot

    harambot
   

   Copy

⁠Run the bot locally using docker

1. Pull the latest image from docker hub

    docker pull dmcp89/harambot
   

   Copy

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]'
   export HARAMBOT_KEY='[YOUR ENCRYPTION KEY]' # A URL-safe base64-encoded 32-byte key
   

   Copy

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 \
    -e HARAMBOT_KEY=$HARAMBOT_KEY \
    --rm dmcp89/harambot
   

   Copy

⁠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
• Manage WebHooks

The permission value should be 277562378304

1. 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.