Update README.md

README.md

@@ -11,4 +11,35 @@ license: apache-2.0
 short_description: Educational French Healthcare NER Demo
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Educational French Healthcare NER Demo
+Book companion for "Natural Language Processing on Oracle Cloud Infrastructure: Building Transformer-Based NLP Solutions Using Oracle AI and Hugging Face"
+
+## 🎯 Purpose
+This Space demonstrates the educational model built in Chapter 6 of the book. 
+It's designed to help you:
+- Understand NER concepts
+- Follow along with the book
+- Test your implementation
+- Learn healthcare NLP
+
+## 📚 Book Integration
+1. Read Chapters 4, 5 and 6
+2. Build the model step-by-step
+3. Compare with this demo
+4. Understand key concepts
+
+## 🚫 Not for Production
+This educational version is not suitable for:
+- Clinical use
+- Production systems
+- Commercial applications
+- Medical decisions
+
+## 💡 Ready for Production?
+Our commercial solutions offer:
+- Custom model training
+- Production deployment
+- Security compliance
+- Enterprise support
+
+[Contact for Commercial Solutions](https://typica.ai/)