wordle-rs

A Wordle game implementation in Rust with a terminal and web UI, supporting multiple languages.

Playing the Game

Play in English (default):

cargo run -p wordle_cli

Play in German:

cargo run -p wordle_cli -- --language de

Language Options

• --language en or -l en - English (default)
• --language de or -l de - German

AI Solver

Run the AI assistant to help solve Wordle puzzles.

Terminal AI Assistant

English (default):

cargo run -p wordle_ai_cli --release -- assistant

German:

cargo run -p wordle_ai_cli --release -- assistant --language de

You can also choose different AI strategies:

cargo run -p wordle_ai_cli --release -- assistant --ai heuristic --language en

AI options (--ai or -a):

• heuristic - Uses letter frequency analysis (default, recommended)
• random-updates - Random guessing with feedback filtering
• random - Pure random guessing
• entropy - Maximum information gain (slower but optimal)

AI Simulation

Evaluate and compare different AI strategies on simulated games.

English wordlist (default):

cargo run -p wordle_ai_cli --release -- simulate --num-games 1000

German wordlist:

cargo run -p wordle_ai_cli --release -- simulate --num-games 1000 --language de

Compare specific AI agents:

cargo run -p wordle_ai_cli --release -- simulate --num-games 1000 --ai heuristic --ai random-updates --language en

Simulation options:

• --num-games or -n - Number of games to simulate (default: 1000)
• --ai or -a - AI agents to test (can specify multiple, defaults to fast agents)
• --language or -l - Language wordlist to use (default: en)

Web Version

Play Wordle in your browser or use the AI assistant at https://wordle.tilmohr.com.

• Play the game at the root URL: https://wordle.tilmohr.com
• Use the AI solver at: https://wordle.tilmohr.com/ai

Alternatively start a local web instance with:

cd wordle_web
trunk serve --open

The web version includes a language selector dropdown to switch between English and German, and navigation buttons to switch between the game and AI solver.

Supported Languages

• English (en)
• German (de) (including words with umlauts ä, ö, ü, ß)

All game modes (CLI game, AI assistant, web assistant, and simulation) support both languages!