Update README.md

README.md

@@ -1,15 +1,51 @@
+---
 title: AICELS
 emoji: 🔥
 colorFrom: yellow
 colorTo: indigo
 sdk: gradio
-sdk_version: 6.1.0
+sdk_version: 5.0.0
 app_file: app.py
 pinned: false
 license: mit
-short_description: AI Code Evaluation and Learning support First release
-This version does not work property at all, but the version on Colab works just fine, we are testing it  and so far so good
+short_description: AI Code Evaluation and Learning System - Correctness First
+---
+
+# 🎓 AICELS: AI-Powered Code Evaluation and Learning System
+
+**Correctness First, Quality Second**
+
+AICELS evaluates Python code in two phases:
+1. **Priority 0 - Correctness**: Does your code run without errors?
+2. **Quality Assessment**: How well does it follow best practices?
+
+## Features
+
+- ✅ Syntax and runtime error detection
+- 📊 PEP 8 compliance checking
+- 📝 Documentation quality assessment
+- 🎯 Naming convention validation
+- 📚 Personalized learning paths
+- 🏆 Quality grading (A/B/C/D)
+
+## How to Use
+
+1. Paste your Python code in the input box
+2. Click "Evaluate Code"
+3. Review your correctness status and quality grade
+4. Follow the personalized learning path to improve
+
+## Philosophy
+
+Unlike traditional code quality tools, AICELS prioritizes functional correctness before style. 
+No amount of beautiful formatting can fix code that doesn't work!
+
+## Development
+
+Developed collaboratively by Paola Bertoldi (Ronin Institute, W3C AI Knowledge Representation Community Group) with Claude (Anthropic).
+
+Currently in testing phase. Colab version working well, HF deployment being refined.
 
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference