# LLM Interactive Choose‑Your‑Own‑Adventure Game

This repository contains a minimal example of a **human‑in‑the‑loop** interactive story powered by LangGraph and OpenAI. The game works as follows:

1. The user supplies a *theme*.
2. The LLM generates a short opening scene and three numbered options.
3. The graph pauses (`interrupt`) and the user selects an option via a console menu.
4. The LLM receives the choice and writes a short ending.

The implementation demonstrates:
- State management with `TypedDict`.
- Interrupts and resuming with `langgraph`.
- Simple parsing of LLM output.
- Console interaction using `questionary`.

## Requirements

```bash
pip install -r requirements.txt
```

You must have an OpenAI API key available in the environment variable `OPENAI_API_KEY`.

## Running the Game

```bash
python game.py
```

You will be prompted for a theme. After the LLM generates the scene, you will see a menu of three options. Pick one and the story will continue to an ending.

## Files

- `game.py` – Main application.
- `requirements.txt` – Python dependencies.
- `README.md` – This documentation.