Come one! Come all!
Let the WordleAI Tournament commence!

Members of Popcorn Robot, I invite you to join our AI tournament. Compete against other WordleAI bots in a tournament bracket competition. Join us if you dare!

Experience level: 2+ months. 
If you worked with lists, then you can participate. Remember, it's just for fun! Use it as an opportunity to exercise your coding skills.

Due date: Submit your bot by Friday, June 24th at 7pm.

Tournament: The tournament will play on Saturday, June 25th at 3pm.


If you never played Wordle, give it a quick play.

Your goal is to create a WordleAI bot that can guess a 5 letter word within 6 tries. 


Getting started:

  1. Create an account on http://replit.com/ 

  2. Click the link below:

  3. Fork the workspace.

How it works:

Open the file ai.py. Your code will go in the run() function.

print_all = True


def run(data, word_list):

  return 'trust'

This is your AI. Whatever you return is your guess. The code above guesses “trust” on every turn. 


print_all is a boolean variable. If you want to see all the messages, set it to True.


run() has 2 arguments, data and word_list.

  • The data argument is a summary of the guesses for the current word.

    The status codes are:
    2 - (Green) correct letter in correct place

    1 - (Yellow) letter in word but wrong place
    0 - (Gray) letter not in word

    ​​​​For example:
    If the answer is “COAST” but you guessed “DETER” and “BRAIN”, your argument will look like this:

    data = [
         {"word": "deter", "status": "00100"}


  • The word_list argument is the word bank we are drawing the answers from in the game.

How points work:

Your WordleAI bot has 6 chances to guess a 5-letter word. The less guesses your bot needs, the more points it gets. If your AI fails to guess the correct word, it receives no points.


For example:

  • The AI correctly guesses the word on the 1st try, so it receives 6 points.

  • The AI correctly guesses the word on the 2nd try, so it receives 5 points.

  • So on so forth…

Submitting your WordleAI bot:

  1. Download your customized ai.py file 

  2. Send an email to popcornrobotwordle@gmail.com 

    1. Add the subject line “WordleAI Bot 2022

    2. In the body, write the following:

      1. Your name

      2. Company you work for, if you are a professional coder.

      3. Or school / self learner if you are learning coding.

    3. Attach the ai.py file. 

    4. Send it by Friday, June 24th at 7pm.

  3. Join the meetup event and watch your bot compete in the tournament on Saturday, June 25th at 3pm.