docs: improve README with usage instructions

README.md

@@ -11,15 +11,20 @@ license: mit
 short_description: Recover structured data from malformed LLM output
 ---
 
-# Operon Chaperone — Interactive Demo
+# 🧬 Operon Chaperone
 
-Try the Chaperone's multi-strategy cascade for recovering structured data from malformed LLM output:
+Recover structured data from malformed LLM output using a multi-strategy cascade -- like protein chaperones refolding misfolded proteins.
 
-1. **STRICT** — Direct JSON parse, no modifications
-2. **EXTRACTION** — Find JSON in markdown blocks, XML tags, or bare objects
-3. **LENIENT** — Type coercion (e.g., `"42"` → `42`)
-4. **REPAIR** — Fix trailing commas, single quotes, Python literals, unquoted keys
+## What to Try
 
-Paste broken JSON, pick a target schema, and watch the cascade recover it.
+1. Open the **Input & Parse** tab, select a schema from the **Target Schema** dropdown (e.g. FunctionCall), paste broken JSON into the input box, and click **Parse** to watch the cascade recover it.
+2. Toggle individual strategies on or off (STRICT, EXTRACTION, LENIENT, REPAIR) to see which one succeeds for different kinds of malformation.
+3. Switch to the **Batch Examples** tab and click **Run All Examples** to see the cascade handle trailing commas, single quotes, markdown-wrapped JSON, and more in one pass.
 
-[GitHub](https://github.com/coredipper/operon) | [Paper](https://github.com/coredipper/operon/tree/main/article)
+## How It Works
+
+The Chaperone tries four folding strategies in order -- strict parsing, extraction from wrappers, lenient type coercion, and structural repair -- stopping at the first success. This mirrors how biological chaperones apply progressively stronger refolding forces to recover functional protein structure.
+
+## Learn More
+
+[GitHub](https://github.com/coredipper/operon) | [PyPI](https://pypi.org/project/operon-ai/) | [Paper](https://github.com/coredipper/operon/tree/main/article)

requirements.txt

@@ -1,3 +1,3 @@
 gradio>=4.0
 pydantic>=2.0
-operon-ai>=0.14.0
+operon-ai>=0.15.0