Update README.md

README.md

@@ -11,3 +11,18 @@ license: mit
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# EvoTransformer Reasoning API
+
+This app lets you ask EvoTransformer a physical or commonsense reasoning question with two answer options. It predicts which one makes more sense — powered by our evolved transformer architecture.
+
+Try scenarios like:
+
+- "You spilled juice on the floor"
+- Option 1: Clean it with a towel
+- Option 2: Cover it with a rug
+
+Evo will suggest the most logical option and show confidence scores.
+
+> Built by Dr. Heman Mohabeer 🇲🇺 — EvoTransformer: The African AI platform that learns live.
+