llm-redactle

A Python-based solver for Redactle puzzles using Large Language Models (LLMs).

This is just weekend fun project it has its quirks.

---

---

Prerequisites

• Python 3.12+
• uv (recommended) or pip

Installation

1. Clone the repository:

   git clone <repository-url>
   cd llm-redactle

2. Install dependencies:

   uv venv --python=3.12
   uv sync

3. Set up environment variables: Create a .env file in the root directory and add your API keys:

   API_KEY=your_api_key_here
   API_BASE=your_api_base_url_here

Usage

Run the solver using the CLI:

python main.py https://redactle.net/ --no-cot --model openai/gpt-4.1 --temperature 0.0

Parameters

• URL: The URL of the Redactle puzzle to solve (e.g., https://redactle.net/22).
• --cot / --no-cot: Dspy Signature with Chain of Thought module or Prediction module. Default: no-cot.
• --model TEXT: The LLM model to use. Default: openai/gpt-4.1.
• --temperature FLOAT: The sampling temperature for the model. Default: 0.0.
• --help: Show the help message.