https://github.com/monitork/ai-wordle-game
https://github.com/monitork/ai-wordle-game
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/monitork/ai-wordle-game
- Owner: monitork
- Created: 2025-08-21T17:51:10.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-21T19:38:06.000Z (10 months ago)
- Last Synced: 2025-08-21T21:55:46.741Z (10 months ago)
- Language: Python
- Size: 12.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AI Wordle Game
## Overview
This project is an AI-powered Wordle game. It features a bot that can play Wordle using different strategies and supports local and API-based gameplay.
## Project Structure
```
main.py # Entry point for the game
requiment.txt # Python dependencies
access/words.txt # Word list used in the game
src/
controllers/
game_controller.py # Main game logic
entities/
api_enum.py # API type enumerations
game_state.py # Game state management
wordle_response.py # Wordle API response model
services/
api_service.py # Handles API calls
bot_service.py # Bot logic for guessing words
local_service.py # Local word list management
```
## How to Run
1. Install dependencies:
```bash
pip install -r requiment.txt
```
2. Start the game:
```bash
python main.py
```
## Download & Run Release
You can download the release here: [AI-Wordle-Game v1.0 Release](https://github.com/monitork/AI-Wordle-Game/releases/tag/v1.0)
### How to run the executable
After downloading, extract and open terminal in the directory containing the executable file (e.g., `dist/main`).
Run the following command on macOS:
```bash
./dist/main
```
If you encounter permission errors, grant execute permissions:
```bash
chmod +x ./dist/main
./dist/main
```
## Features
- Play Wordle with an AI bot
- Supports daily, random, and word-based game modes
- API integration for word validation
- Local word list support
## References
- [Science Thinks It Has Found the Best Wordle Starter](https://lifehacker.com/science-thinks-it-has-found-the-best-wordle-starter-1849541276)
- Some word best to start: "SLATE", "CRANE", "SLANT", "TRACE", "CRATE", "PLANT", "SPELT"
- [Information Theory Through Wordle](https://towardsdatascience.com/heres-what-i-learned-about-information-theory-through-wordle-c835319cc87f/)
- Shannon entropy: -Σ(p * log2(p))
- [ChatGPT](https://chatgpt.com) I used ChatGPT with the prompt: “Build a Wordle AI Game using the entropy algorithm.” to
- [Github Copilot](https://github.com/features/copilot) for suggestion