Wordle solver leaderboard

Wordle solver leaderboards.

• 🏁 Implement a solver that requires less number of turns to solve less execution time. The fewer the number of turns required, the shorter the execution time for the same number of turns, the higher the rank.
• 👨‍💻👩‍💻 You can focus on implementing the algorithm. All you need to do is to implement a simple REPL program. The measurement tool will interact with your solver, manipulate the browser, and calculate your score.
• 🕛 The leaderboard will be updated automatically every day around 12am UTC.

You can see the leaderboard here. https://www.wordle-solver.dev/

Runtimes

Right now, we support these languages.

• Node.js (v16.x): reference implementation
• Rust (v1.58): reference implementation
• Deno (v1.18)

Do you need a runtime in a different language than above? CONTRIBUTING

How to participate

Please refer to CONTRIBUTING.md.

How the runner works

sequenceDiagram
    participant Runner
    participant solver as Your solver
    participant Wordle
    participant Leaderboard

    activate Runner
    Runner->>Runner: Build your solver<br>into a Docker image.
    Runner->>Wordle: Open the page<br>and wait for the app is ready
    activate Wordle
    Wordle->>Runner: Wordle App
    Runner->>solver: Run the Docker image
    activate solver
    loop until it solve the correct answer or the game is over.
        rect rgb(200, 150, 255)
            solver->>Runner: [STDOUT] Respond the word
        end
        Runner->>Wordle: Input the word and wait for the result
        Wordle->>Wordle: Render the result
        Runner->>Wordle: Extract the result
        Wordle->>Runner: The result
        rect rgb(200, 150, 255)
            Runner->>solver: [STDIN] The result
        end
    end
    Runner->>solver: Stop
    deactivate solver
    Runner->>Wordle: Close the page
    deactivate Wordle
    Runner->>Runner: Collect the stats
    Runner->>Leaderboard: Upload the stats
    deactivate Runner

Loading

• When the process starts, first output the first word and new line character (\n) to STDOUT.
  • ex. count\n
• The response from Wordle will be given as a CSV to the STDIN
  • ex. correct,absent,present,present,correct\n (:green_square::white_large_square::yellow_square::yellow_square::green_square:)
  • correct = 🟩
  • present = 🟨
  • absent = ⬜
  • If all the parts are correct, it means that the word you chose is the correct answer. Please terminate the process.
• If the word output by solver is not registered in Wordle, the special string NOT_IN_WORD_LIST will be given to the STDIN. In that case, output a different word to STDOUT.

Regulation

• STDOUT should be used only for responses to runner. All debug and error logs should be output to STDERR. The logs will be automatically collected and can be viewed on the execution detail page.
  • Please keep logging to a minimum. Logs will be automatically truncated to save space.
• Please don't rely on OS-specific features. It can be changed.
• Please don't access to the internet.
• If your solver process has been running for more than 3 minutes, it will be forcibly killed. In that case, the answer will fail and neither the number of turns nor the execution time will be displayed.
• If there is a problem with a contestant's code that causes a problem with the system, it will be removed without notice.