diff --git a/README.md b/README.md
index 8eaf6cf..01b94db 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,11 @@
 > **A lightweight, educational RAG system that actually works**  
 > *Built for beginners who want results, and developers who want to understand how RAG really works*
 
-![FSS-Mini-RAG Icon](assets/icon.png)
+## Demo
+
+![FSS-Mini-RAG Demo](recordings/fss-mini-rag-demo-20250812_161410.gif)
+
+*See it in action: index a project and search semantically in seconds*
 
 ## How It Works
 
@@ -14,7 +18,7 @@ graph LR
     Chunks --> Embeddings[🧠 Semantic Vectors]
     Embeddings --> Database[(💾 Vector DB)]
     
-    Query[❓ "user auth"] --> Search[🎯 Hybrid Search]
+    Query[❓ user auth] --> Search[🎯 Hybrid Search]
     Database --> Search
     Search --> Results[📋 Ranked Results]
     
@@ -108,6 +112,10 @@ That's it. No external dependencies, no configuration required, no PhD in comput
 ./rag-mini status ~/new-project            # Check index health
 ```
 
+![FSS-Mini-RAG Search Demo](recordings/fss-mini-rag-demo-20250812_160725.gif)
+
+*Advanced usage: semantic search with synthesis and exploration modes*
+
 ## Installation Options
 
 ### Recommended: Full Installation