# kaleabtesfaye01/wordle-solver architecture

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

- Interactive diagram: https://gitdiagram.com/kaleabtesfaye01/wordle-solver
- Repository: https://github.com/kaleabtesfaye01/wordle-solver

## Overview

Wordle Solver is an assistant for narrowing possible answers from the feedback a player enters after a guess. Players can use either the terminal workflow or the Streamlit interface; both load the word lists, maintain a game session, and suggest a candidate. The session logic computes feedback matches, filters remaining answers, and tracks available letters. The Streamlit app also presents the board and game status. The excerpts show these main calls; unsampled data contents and other runtime details are not inferred.

Main entry points: [`wordle_solver/cli.py`](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/cli.py) (Terminal workflow), [`wordle_solver/streamlit_app.py`](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/streamlit_app.py) (Streamlit app), [`wordle_solver/session.py`](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py) (Game session), [`wordle_solver/data.py`](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/data.py) (Word-list loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User workflows"]
  node_cli["Terminal workflow<br/>[cli.py]"]
  node_web["Streamlit app<br/>[streamlit_app.py]"]
end

subgraph group_core["Solver session"]
  node_session["Game session<br/>[session.py]"]
  node_feedback["Feedback matching<br/>[session.py]"]
  node_filter["Candidate filtering<br/>[session.py]"]
  node_suggest["Answer suggestion<br/>[session.py]"]
  node_letters["Available letters<br/>[session.py]"]
end

subgraph group_words["Word lists"]
  node_loader["Word-list loader<br/>[data.py]"]
  node_allowed["Allowed guesses"]
  node_answers["Answer list"]
end

node_player(("Player"))

node_player -->|"uses"| node_cli
node_player -->|"uses"| node_web
node_cli -->|"loads lists"| node_loader
node_web -->|"loads lists"| node_loader
node_loader -->|"reads"| node_allowed
node_loader -->|"reads"| node_answers
node_cli -->|"creates session"| node_session
node_web -->|"creates session"| node_session
node_cli -->|"requests guess"| node_suggest
node_web -->|"requests guess"| node_suggest
node_cli -->|"applies turn"| node_session
node_web -->|"applies turn"| node_session
node_session -->|"filters answers"| node_filter
node_filter -->|"matches feedback"| node_feedback
node_session -->|"updates letters"| node_letters
node_cli -->|"validates input"| node_feedback
node_web -->|"uses validators"| node_cli

click node_cli "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/cli.py"
click node_web "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/streamlit_app.py"
click node_loader "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/data.py"
click node_allowed "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/data/wordle-allowed-guesses.txt"
click node_answers "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/data/wordle-answers-alphabetical.txt"
click node_session "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py"
click node_feedback "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py"
click node_filter "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py"
click node_suggest "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py"
click node_letters "https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py"

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_cli,node_web toneBlue
class node_session,node_feedback,node_filter,node_suggest,node_letters toneAmber
class node_loader,node_allowed,node_answers toneMint
class node_player toneIndigo
```

## Components

### User workflows

- [Terminal workflow](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/cli.py): `wordle_solver/cli.py`
- [Streamlit app](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/streamlit_app.py): `wordle_solver/streamlit_app.py`

### Solver session

- [Game session](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py): `wordle_solver/session.py`
- [Feedback matching](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py): `wordle_solver/session.py`
- [Candidate filtering](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py): `wordle_solver/session.py`
- [Answer suggestion](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py): `wordle_solver/session.py`
- [Available letters](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/session.py): `wordle_solver/session.py`

### Word lists

- [Word-list loader](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/wordle_solver/data.py): `wordle_solver/data.py`
- [Allowed guesses](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/data/wordle-allowed-guesses.txt): `data/wordle-allowed-guesses.txt`
- [Answer list](https://github.com/kaleabtesfaye01/wordle-solver/blob/main/data/wordle-answers-alphabetical.txt): `data/wordle-answers-alphabetical.txt`

### Other components

- **Player**

## Connections

- Player → Terminal workflow: uses (evidence: `README.md`)
- Player → Streamlit app: uses (evidence: `README.md`)
- Terminal workflow → Word-list loader: loads lists (evidence: `wordle_solver/cli.py`)
- Streamlit app → Word-list loader: loads lists (evidence: `wordle_solver/streamlit_app.py`)
- Word-list loader → Allowed guesses: reads (evidence: `wordle_solver/data.py`)
- Word-list loader → Answer list: reads (evidence: `wordle_solver/data.py`)
- Terminal workflow → Game session: creates session (evidence: `wordle_solver/cli.py`)
- Streamlit app → Game session: creates session (evidence: `wordle_solver/streamlit_app.py`)
- Terminal workflow → Answer suggestion: requests guess (evidence: `wordle_solver/cli.py`)
- Streamlit app → Answer suggestion: requests guess (evidence: `wordle_solver/streamlit_app.py`)
- Terminal workflow → Game session: applies turn (evidence: `wordle_solver/cli.py`)
- Streamlit app → Game session: applies turn (evidence: `wordle_solver/streamlit_app.py`)
- Game session → Candidate filtering: filters answers (evidence: `wordle_solver/session.py`)
- Candidate filtering → Feedback matching: matches feedback (evidence: `wordle_solver/session.py`)
- Game session → Available letters: updates letters (evidence: `wordle_solver/session.py`)
- Terminal workflow → Feedback matching: validates input (evidence: `wordle_solver/cli.py`)
- Streamlit app → Terminal workflow: uses validators (evidence: `wordle_solver/streamlit_app.py`)
