diff --git a/README.md b/README.md
index e55f9d3..6e63908 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,24 @@
-# task-6a1d75e5fd30e81cf3126b1a
+# Structured Output Union Events API
 
+## Overview
+This project demonstrates how to parse a raw log containing HTTP events into typed Pydantic models using LangChain’s structured output. It supports two event types – successful requests and errors – and aggregates them into a list.
+
+## Files
+- `main.py` – CLI entry point with example log and parsing logic.
+- `models.py` – Pydantic v2 models for the events.
+- `requirements.txt` – Dependencies.
+- `README.md` – Project description.
+
+## Installation
+```bash
+pip install -r requirements.txt
+```
+
+## Usage
+Run the script:
+```bash
+python main.py
+```
+You can also pass a custom log via stdin or as an argument.
+
+The output will be a table of parsed events and their JSON representations.