Installation
============

Python
------

This project targets Python 3.10+ (recommended: 3.11).

Install dependencies
--------------------

From the repo root:

.. code-block:: bash

   python -m pip install -r requirements.txt

Environment variables
---------------------

This toolkit uses OpenAI/OpenRouter style clients across modules.

- ``OPENAI_API_KEY``: used by some components (e.g. judging, web retrieval).
- ``OPENROUTER_API_KEY``: used when calling models via OpenRouter in some utilities.

Preflight validation
--------------------

Before running long searches:

.. code-block:: bash

   python validate_config.py