Update README.md with new content

Author: Lilmoki91

README.md

@@ -1,2 +1,109 @@
-# Azura-Ai-Web-Search
-Platform Ai web searching  sources education  student school 
+# 🌐 Azura AI Web Search 🇲🇾
+
+![Azura AI Web Search Banner](https://raw.githubusercontent.com/Lilmoki91/Azura-Ai-Web-Search/main/banner.png)
+
+Azura AI Web Search adalah projek sumber terbuka carian web yang menggunakan teknologi AI untuk memperkayakan maklumat hasil carian. Ia menggunakan enjin DuckDuckGo®, Wikipedia API, dan model AI (Gemma-3-27B IT) untuk menjana jawapan pintar dalam satu antara muka moden dan responsif.
+
+> **Nota:** Ini adalah platform **pendidikan & eksperimen** dibangunkan pelajar Malaysia, dibuka untuk komuniti meneroka dan menyumbang.
+
+---
+
+## ✨ Ciri-ciri
+
+- **Carian Multi-Engine**: Gabungan DuckDuckGo® & Wikipedia dalam satu input
+- **Jawapan AI**: Menjana ringkasan pintar menggunakan model AI opensource
+- **Antara muka moden**: UI gelap, responsif, ikon FontAwesome, tema gradient
+- **Panel menu & Share**: Sidebar info, sumbangan, serta butang perkongsian sosial
+- **Keselamatan**: Perlindungan XSS (input validator), had input dan corak dibenarkan
+- **Kemas kini masa nyata**: Loading animasi, butang reload, clear input pintar
+- **Sokongan Bahasa**: _multi-bahasa UI_ (default: Melayu)
+- **Sumbangan komuniti**: Kod terbuka untuk penambahbaikan bersama
+
+---
+
+## 🚀 Mula Pantas
+
+#### 1. Klon Repo
+
+```bash
+git clone https://github.com/Lilmoki91/Azura-Ai-Web-Search.git
+cd Azura-Ai-Web-Search
+```
+
+#### 2. Guna Terus di Lokal
+
+Hanya buka `index.html` dalam pelayar anda:
+
+```txt
+(open folder, double click index.html atau buka dengan VSCode Live Server)
+```
+
+#### 3. Deploy ke GitHub Pages (optional)
+
+- Fork atau klon repo ini
+- Di repo anda, aktifkan **GitHub Pages** (branch: `main`, folder `/`)
+- URL anda: `https://<username>.github.io/Azura-Ai-Web-Search`
+
+---
+
+## ⚙️ Konfigurasi
+
+**Kunci API**:
+- _(pilihan/sekadar contoh untuk demo AI)_  
+  Untuk fungsi AI, sesetengah endpoint mungkin perlukan `API_KEY`.
+
+**Modifikasi Engine Carian**:
+- Anda boleh tambah atau ubah `SEARCH_ENGINES` dalam `index.html`.
+
+---
+
+## 📸 Screenshot
+
+![UI contoh](https://raw.githubusercontent.com/Lilmoki91/Azura-Ai-Web-Search/main/screenshot.png)
+
+---
+
+## 👨‍💻 Cara Guna
+
+1. **Taip soalan/carian** dalam kotak input.
+2. Tekan butang `Cari` atau `Enter`.
+3. Lihat hasil ringkasan AI dan sumber asal di panel _Sources_.
+4. Guna ikon sidebar (☰) untuk menu, info pembangun, atau _share link_.
+
+---
+
+## 💡 Sumbangan
+
+- **Isu / Bug**: Buka [issue](https://github.com/Lilmoki91/Azura-Ai-Web-Search/issues) jika jumpa pepijat atau mahu ciri baharu.
+- **PR**: Fork repo, commit perubahan, dan buat **Pull Request** — semua sumbangan dialu-alukan.
+- **Diskusi**: Guna menu Help & Q&A, atau hubungi pembangun di Telegram: [@johansetia](https://t.me/johansetia)
+
+---
+
+## 📜 Lesen
+
+Projek ini di bawah [MIT License](LICENSE).
+
+---
+
+## ❤️ Kredit & Terima kasih
+
+- **DuckDuckGo® API**
+- **Wikipedia REST API**
+- **Google Generative Language (Gemma)**
+- **Font Awesome, JetBrains Mono, Inter Font**
+- **Penyumbang & komuniti opensource**
+
+---
+
+**Dibangunkan oleh:**  
+Zulkarnain Bin Suyitno  
+Sekolah Menengah Kebangsaan Rantau Panjang, Klang, Selangor
+
+---
+
+> Platform ini untuk pembelajaran & komuniti. Setiap sumbangan diterima dengan penuh penghargaan 🤗.
+
+---
+
+**_Jom #SumberTerbuka & hidupkan ekosistem AI Malaysia!_**