Update README.md

README.md

@@ -1,3 +1,9 @@
+---
+license: mit
+sdk: docker
+emoji: 📚
+short_description: Collaborative Testing for LLM & Agentic Applications
+---
 # Rhesis: Collaborative Testing for LLM & Agentic Applications
 
 <p align="center">
@@ -46,7 +52,7 @@ Generate tests from requirements, simulate conversation flows, detect adversaria
 
 <p align="center">
   <a href="https://rhesis.ai/?video=open" target="_blank">
-    <img src="https://github.com/rhesis-ai/rhesis/blob/main/.github/images/GH_Short_Demo.png"
+    <img src="https://raw.githubusercontent.com/rhesis-ai/rhesis/main/.github/images/GH_Short_Demo.png"
          loading="lazy"
          width="1080"
          alt="Rhesis Platform Overview - Click to watch demo">
@@ -58,7 +64,7 @@ Generate tests from requirements, simulate conversation flows, detect adversaria
 ## Core features
 
 <p align="center">
-  <img src="https://github.com/rhesis-ai/rhesis/blob/main/.github/images/GH_Features.png"
+  <img src="https://raw.githubusercontent.com/rhesis-ai/rhesis/main/.github/images/GH_Features.png"
        loading="lazy"
        width="1080"
        alt="Rhesis Core Features">
@@ -193,6 +199,45 @@ Six integrated phases from project setup to team collaboration:
 
 ---
 
+## What you can test
+
+| Use Case | What Rhesis Tests |
+|----------|-------------------|
+| **Conversational AI** | Conversation simulation, role adherence, knowledge retention |
+| **RAG Systems** | Context relevance, faithfulness, hallucination detection |
+| **NL-to-SQL / NL-to-Code** | Query accuracy, syntax validation, edge case handling |
+| **Agentic Systems** | Tool selection, goal achievement, multi-agent coordination |
+
+---
+
+## SDK: Code-first testing
+
+Test your Python functions directly with the `@endpoint` decorator:
+
+```python
+from rhesis.sdk.decorators import endpoint
+
+@endpoint(name="my-chatbot")
+def chat(message: str) -> str:
+    # Your LLM logic here
+    return response
+```
+
+**Features:** Zero configuration, automatic parameter binding, auto-reconnection, environment management (dev/staging/production).
+
+**Generate tests programmatically:**
+
+```python
+from rhesis.sdk.synthesizers import PromptSynthesizer
+
+synthesizer = PromptSynthesizer(
+    prompt="Generate tests for a medical chatbot that must never provide diagnosis"
+)
+test_set = synthesizer.generate(num_tests=10)
+```
+
+---
+
 ## Deployment options
 
 | Option | Best For | Setup Time |
@@ -249,7 +294,7 @@ See [Integration Docs](https://docs.rhesis.ai/development) for setup instruction
 
 ## Open source
 
-[MIT licensed](LICENSE). No plans to relicense core features. Enterprise version live in `ee/` folders and remain separate.
+[MIT licensed](LICENSE). No plans to relicense core features. Enterprise version will live in `ee/` folders and remain separate.
 
 We built Rhesis because existing LLM testing tools didn't meet our needs. If you face the same challenges, contributions are welcome.