README.md

metadata

title: Wordle Solver
emoji: 🧩
colorFrom: blue
colorTo: purple
sdk: docker
sdk_version: 1.0.0
app_file: app.py
pinned: false
license: mit

Wordle Solver 🧩

An intelligent Wordle solver that uses entropy-based algorithms to suggest optimal guesses in real-time.

✨ Features

• 🧠 Entropy-based solving: Uses information theory to maximize information gain with each guess
• 🎨 Interactive interface: Intuitive color-coded feedback system (Green/Yellow/Gray)
• ⚡ Real-time suggestions: Get optimal word suggestions instantly after each guess
• 📊 Historical testing: Tested against all historical Wordle answers
• 🔄 Game reset: Start fresh anytime with the reset button
• 📱 Responsive design: Works on desktop and mobile devices

🎮 How to Use

1. Start with "ARISE": The solver always suggests "ARISE" as the first guess
2. Enter feedback: Use the color buttons to indicate the result:
   • 🟩 Green: Letter is correct and in the right position
   • 🟨 Yellow: Letter is in the word but wrong position
   • ⬛ Gray: Letter is not in the word
3. Get next suggestion: Click "Next Row" to receive the optimal next guess
4. Continue solving: Repeat until you find the word!

🛠️ Technical Details

• Backend: Flask (Python)
• Frontend: HTML/CSS/JavaScript
• Algorithm: Entropy-based information maximization
• Word database: ~13,000 possible 5-letter words
• Performance: Average solve rate of 3.89 guesses
• Deployment: Docker containerized for easy deployment

🧪 Testing

The solver has been tested against all historical Wordle answers with:

• Success rate: ~99%+
• Average guesses: 3.89
• Maximum guesses: Rarely exceeds 6

⚠️ Disclaimer

This solver is unofficial and not affiliated with the New York Times or Wordle. It's created for educational and entertainment purposes only.

---

Happy solving! 🎯