# cmiyai/nyt-gamesolver architecture

> Architecture diagram of the GitHub repository cmiyai/nyt-gamesolver, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cmiyai/nyt-gamesolver
- Repository: https://github.com/cmiyai/nyt-gamesolver

## Overview

NYT Game Solver is a small suite centered on Wordle. Its automated workflow fetches the daily puzzle, loads precomputed patterns and word lists, selects guesses using entropy and beam search, filters possible answers, and writes a dated JSON result. A separate interactive mode accepts a player’s guesses and color feedback. Connections is listed as supported but marked “Coming soon”; its implementation and any frontend consumer are not established by the inspected evidence.

Main entry points: [`wordle/solve_wordle.py`](https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/solve_wordle.py) (Daily solver), [`wordle/solver.py`](https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/solver.py) (Interactive solver), [`wordle/words`](https://github.com/cmiyai/nyt-gamesolver/tree/main/wordle/words) (Word lists), [`wordle/wordle_pattern_matrix.npy`](https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/wordle_pattern_matrix.npy) (Pattern matrix)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_wordle["Wordle solving"]
  node_auto["Daily solver<br/>[solve_wordle.py]"]
  node_interactive["Interactive solver<br/>[solver.py]"]
  node_entropy["Pattern entropy<br/>[solver.py]"]
end

subgraph group_resources["Wordle resources"]
  node_wordlists["Word lists"]
  node_patternmatrix["Pattern matrix"]
end

subgraph group_results["Results and games"]
  node_dailyresults["Daily result files"]
  node_connections["Connections notes<br/>[connections.md]"]
end

node_player(("Player"))
node_nyt(("NYT Wordle"))

node_auto -->|"fetches puzzle"| node_nyt
node_auto -->|"loads word lists"| node_wordlists
node_auto -->|"loads patterns"| node_patternmatrix
node_auto -->|"scores guesses"| node_entropy
node_auto -->|"writes results"| node_dailyresults
node_player -->|"enters feedback"| node_interactive
node_interactive -->|"ranks guesses"| node_entropy
node_interactive -->|"loads word lists"| node_wordlists
node_interactive -->|"loads patterns"| node_patternmatrix

click node_auto "https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/solve_wordle.py"
click node_interactive "https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/solver.py"
click node_entropy "https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/solver.py"
click node_wordlists "https://github.com/cmiyai/nyt-gamesolver/tree/main/wordle/words"
click node_patternmatrix "https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/wordle_pattern_matrix.npy"
click node_dailyresults "https://github.com/cmiyai/nyt-gamesolver/tree/main/frontend/public"
click node_connections "https://github.com/cmiyai/nyt-gamesolver/blob/main/connections/connections.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auto,node_interactive,node_entropy toneBlue
class node_wordlists,node_patternmatrix toneAmber
class node_dailyresults,node_connections toneMint
class node_player,node_nyt toneIndigo
```

## Components

### Wordle solving

- [Daily solver](https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/solve_wordle.py): `wordle/solve_wordle.py`
- [Interactive solver](https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/solver.py): `wordle/solver.py`
- [Pattern entropy](https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/solver.py): `wordle/solver.py`

### Wordle resources

- [Word lists](https://github.com/cmiyai/nyt-gamesolver/tree/main/wordle/words): `wordle/words`
- [Pattern matrix](https://github.com/cmiyai/nyt-gamesolver/blob/main/wordle/wordle_pattern_matrix.npy): `wordle/wordle_pattern_matrix.npy`

### Results and games

- [Daily result files](https://github.com/cmiyai/nyt-gamesolver/tree/main/frontend/public): `frontend/public`
- [Connections notes](https://github.com/cmiyai/nyt-gamesolver/blob/main/connections/connections.md): `connections/connections.md`

### Other components

- **Player**
- **NYT Wordle**

## Connections

- Daily solver → NYT Wordle: fetches puzzle (evidence: `wordle/solve_wordle.py`)
- Daily solver → Word lists: loads word lists (evidence: `wordle/solve_wordle.py`)
- Daily solver → Pattern matrix: loads patterns (evidence: `wordle/solve_wordle.py`)
- Daily solver → Pattern entropy: scores guesses (evidence: `wordle/solve_wordle.py`)
- Daily solver → Daily result files: writes results (evidence: `wordle/solve_wordle.py`)
- Player → Interactive solver: enters feedback (evidence: `wordle/solver.py`)
- Interactive solver → Pattern entropy: ranks guesses (evidence: `wordle/solver.py`)
- Interactive solver → Word lists: loads word lists (evidence: `wordle/solver.py`)
- Interactive solver → Pattern matrix: loads patterns (evidence: `wordle/solver.py`)
