Update README.md

README.md

@@ -17,3 +17,19 @@ Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :hear
 
 If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
 forums](https://discuss.streamlit.io).
+
+# Arabic Poetry Lab – Meters, Diacritization & Generation
+
+A Streamlit Space to try Arabic poetry models featured in recent papers:
+- Meter classification (AraPoemBERT, MetRec GRU, APCD2 BiLSTM)
+- Era / Theme (Ashaar)
+- Diacritization (Ashaar diacritizer)
+- Poetry generation (Ashaar char-GPT, AraGPT2, GPT-J)
+
+## Use
+1) Create a Hugging Face Space → Streamlit.
+2) Add `app.py` and `requirements.txt`.
+3) (Optional) Set Space hardware to GPU for big generators.
+
+## Model IDs
+Paste exact model repo IDs in the UI for any placeholder entries (e.g., `faisalq/AraPoemBERT-meter`, `ARBML/ashaar-diacritizer`, etc.).