feat: solution for 'текстовая игра на основе llm + interrupt'

README.md

@@ -0,0 +1,68 @@
+```
+# Interactive Choose‑Your‑Own‑Adventure
+
+This project demonstrates a simple text adventure game that uses an LLM (OpenAI) to generate a story opening, presents the user with three choices, and then continues the story based on the chosen option.  
+The flow is built with **LangGraph** and uses **interrupts** to pause the graph and wait for user input in the console.
+
+## Features
+
+- Generates a short opening and three distinct choices using an LLM.
+- Pauses execution with an interrupt and presents the choices via a console menu.
+- Resumes the graph with the user’s selection and generates a short ending.
+- Stores the entire story (topic, opening, choice, ending) in a JSON file.
+
+## Prerequisites
+
+- Python 3.10+
+- An OpenAI API key. Set it in your environment:
+
+```bash
+export OPENAI_API_KEY="sk-..."
+```
+
+## Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/interactive-adventure.git
+cd interactive-adventure
+
+# Create a virtual environment (optional but recommended)
+python -m venv .venv
+source .venv/bin/activate   # On Windows: .venv\Scripts\activate
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+## Usage
+
+```bash
+python src/main.py
+```
+
+You will be prompted to enter a topic for the adventure.  
+After the LLM generates the opening and choices, a menu will appear.  
+Select an option, and the story will continue with a short ending.  
+The final story will be printed to the console and saved to `adventure_story.json`.
+
+## Project Structure
+
+```
+interactive-adventure/
+├── src/
+│   └── main.py          # Main application logic
+├── requirements.txt     # Python dependencies
+└── README.md            # Documentation
+```
+
+## Customization
+
+- **LLM Model**: Change the `model` parameter in `ChatOpenAI` inside `src/main.py` to use a different model.
+- **Prompt Templates**: Modify the prompt strings in `generate_scene_and_choices` and `generate_ending` to tweak the story style.
+- **Number of Choices**: Adjust the parsing logic if you want more or fewer options.
+
+## License
+
+MIT License
+```