"Meneroka ilmu dengan teknologi terkini - sumber terbuka untuk semua"
- Tentang Projek
- Ciri-ciri Utama
- Demo Langsung
- Sistem Keselamatan
- Struktur Projek
- Mula Pantas
- Konfigurasi
- Cara Guna
- Tangkapan Skrin
- Sumbangan
- Kredit dan Penghargaan
- Pembangun
- Pengiktirafan
- Derma dan Sumbangan
- Lesen
- Pesanan dan Penutup
- Pesanan dan Penutup teks jawi
Azura AI Web Search adalah projek sumber terbuka (open-source) yang menggabungkan enjin carian web dengan teknologi AI untuk memberikan pengalaman mencari maklumat yang lebih pintar dan bermakna.
🎯 Objektif: Menyediakan platform carian pendidikan yang memanfaatkan AI untuk merumuskan maklumat dari pelbagai sumber, memudahkan pembelajaran dan penyelidikan.
Dibangunkan persendirian oleh Zulkarnain bin Suyitno — pelajar Sekolah Menengah Kebangsaan Rantau Panjang Klang Selangor Malaysia 🇲🇾, bertujuan sebagai projek pembelajaran dan sumbangan kepada komuniti teknologi tempatan Malaysia 🇲🇾.
• 🔍 DuckDuckGo® API - Enjin carian utama
• 📚 Wikipedia REST API - Sumber kandungan pendidikan
• 🧠 Gemma-3-27B IT - Model AI Google untuk ringkasan pintar
• ☁️ Cloudflare - Hosting & proxy workers
• 🔒 IPFS + AES-GCM - Penyimpanan API key yang selamat
| Kategori | Penerangan | |
|---|---|---|
| 🔍 | Carian Multi-Engine | Gabungan DuckDuckGo® & Wikipedia dalam satu input |
| 🤖 | Jawapan AI | Ringkasan pintar menggunakan model AI Gemma-3 |
| 🎨 | Antara Muka Moden | UI gelap, responsif, ikon FontAwesome, tema gradient |
| 📱 | PWA Sedia | Boleh install macam app di telefon (manifest + service worker) |
| 🛡️ | Keselamatan | Perlindungan XSS, input validator, had input |
| 🔄 | Kemas Kini Masa Nyata | Loading animasi, butang reload, clear input pintar |
| 🌍 | Sokongan Bahasa | UI pelbagai bahasa (default: Melayu) |
| 👥 | Sumber Terbuka | Kod terbuka untuk sumbangan komuniti |
Azura AI menggunakan pendekatan keselamatan 3-lapisan untuk melindungi API key:
┌─────────────────────────────────────────────────────┐
│ 🔐 LAPISAN 1: IPFS STORAGE │
│ ├─ API key disimpan dalam IPFS │
│ ├─ Content Identifier (CID): Qmb5ES6... │
│ └─ Desentralisasi - tiada single point of failure │
├─────────────────────────────────────────────────────┤
│ 🔑 LAPISAN 2: AES-GCM ENCRYPTION │
│ ├─ Data disulit dengan AES sebelum muat naik │
│ ├─ 256-bit encryption standard │
│ └─ Hanya worker yang boleh decrypt │
├─────────────────────────────────────────────────────┤
│ ☁️ LAPISAN 3: CLOUDFLARE WORKER │
│ ├─ Proxy permintaan ke Google AI │
│ ├─ Elak CORS & IP blocking │
│ └─ Tambah lapisan keselamatan │
└─────────────────────────────────────────────────────┘
Mengapa pendekatan ini?
-
✅ Tiada API key didedahkan dalam kod sumber
-
✅ Selamat dari serangan XSS dan injection
-
✅ Mudah dikemas kini tanpa deploy semula
-
✅ Boleh digunakan oleh ramai pengguna serentak
📦 Azura-Ai-Web-Search
├── 📄 index.html # Halaman utama aplikasi
├── 📄 manifest.json # Konfigurasi PWA
├── 📄 sw.js # Service Worker untuk offline capability
├── 🖼️ AZURA-LOGO.png # Logo utama
├── 🖼️ AZURA-AI.webp # Background image
├── 🖼️ icon-192.png # Ikon PWA (192px)
├── 🖼️ icon-512.png # Ikon PWA (512px)
├── 🖼️ icon-192-maskable.png # Ikon maskable untuk PWA
├── 🖼️ icon-512-maskable.png # Ikon maskable untuk PWA
├── 🖼️ Azura-Ai-WebSearch.jpg # Screenshot aplikasi
├── 🖼️ Azura-Ai-Wallpaper.png # Wallpaper untuk banner
├── 🖼️ RHB-BANK-QR.jpg # QR code RHB Bank (derma)
├── 🖼️ TNG-QR.jpg # QR code Touch 'n Go (derma)
├── 🖼️ wld-acc.jpg # QR code WorldChain (derma)
├── 📄 README.md # Dokumentasi projek (anda di sini!)
└── 📄 LICENSE # Lesen MIT
• Pelayar web moden (Chrome, Firefox, Edge, Safari)
• Text editor (VS Code, Sublime Text) - untuk ubahsuai
• Git (optional)
# 1. Clone repositori
git clone https://github.com/Lilmoki91/Azura-Ai-Web-Search.git
# 2. Masuk ke folder projek
cd Azura-Ai-Web-Search
# 3. Buka index.html dalam pelayar
# Cara 1: Double click index.html
# Cara 2: Guna Live Server (VSCode)
# Cara 3: Python HTTP server
python -m http.server 8000
# Kemudian buka http://localhost:80001. Buka https://dash.cloudflare.com
2. Klik Workers & Pages > Create application > Pages
3. Connect GitHub account
4. Pilih repo "Azura-Ai-Web-Search"
5. Klik "Save and Deploy"
6. Selesai! Dapat URL seperti: https://azura-ai-web-search.pages.devSistem menggunakan IPFS + AES-GCM encryption. Tiada API key didedahkan dalam kod sumber.
// Config dalam index.html
IPFS_CONFIG = {
cid: "Qmb5ES6JihBKaeQ9yah39Vy7QXh1Ls6CuaHBzatE8ZBdHV",
aesKey: "++YYOXRnKIuM69sJq6eTBm4g3yB+MKInltySJrGm9p0=",
gateway: "https://gateway.pinata.cloud/ipfs/"
}Anda boleh tambah atau ubah SEARCH_ENGINES dalam index.html:
const SEARCH_ENGINES = {
duckduckgo: 'https://api.duckduckgo.com/',
wikipedia: 'https://en.wikipedia.org/api/rest_v1/',
// Tambah enjin lain di sini
};
-
Taip soalan/carian dalam kotak input di halaman utama
-
Tekan butang "Cari" atau kekunci Enter pada papan kekunci
-
Tunggu proses - animasi loading akan dipaparkan semasa AI memproses
-
Lihat hasil ringkasan AI yang dijana oleh model Gemma-3
-
Rujuk sumber asal di panel "Sources" untuk maklumat lanjut
-
Guna ikon sidebar (☰) untuk: • Menu navigasi
• Info pembangun
• Share link
• Help & FAQ
• Buka di Chrome/Edge/Safari
• Klik "Install App" atau "Add to Home Screen"
• Guna seperti aplikasi native
🏠 Halaman Utama Antaramuka carian utama |
📊 Hasil Carian Ringkasan AI + sumber |
📱 Mod Mudah Alih PWA sedia install |
Kami mengalu-alukan sumbangan daripada semua! Sama ada anda developer, designer, atau pengguna biasa.
# 1. Fork repositori ini
# 2. Clone fork anda
git clone https://github.com/[username-anda]/Azura-Ai-Web-Search.git
# 3. Buat branch baru
git checkout -b fitur-baru-anda
# 4. Commit perubahan
git add .
git commit -m "Tambah: [huraian ringkas perubahan]"
# 5. Push ke branch anda
git push origin fitur-baru-anda
# 6. Buat Pull Request di GitHub🐛 Lapor Bug Jumpa masalah? Buat issue di GitHub
💡 Cadangan Fitur Ada idea menarik? Kongsikan!
📝 Dokumentasi Bantu kemas kini README atau docs
🌐 Terjemahan Tambah sokongan bahasa baru
🎨 UI/UX Cadangkan penambahbaikan reka bentuk
⚡ Optimisasi Bantu jadikan kod lebih efisien
🔍 DuckDuckGo® Enjin carian utama (API)
📚 Wikipedia Sumber kandungan pendidikan (REST API)
🧠 Google Gemma Model AI untuk ringkasan pintar
☁️ Cloudflare Hosting & Workers (proxy)
📦 IPFS & Pinata Storage encrypted API key
🎨 Font Awesome Ikon-ikon cantik
✍️ JetBrains Mono Font coding yang elegan
📝 Inter Font Font utama untuk UI
Terima kasih khas kepada:
• Semua pengguna yang mencuba dan memberi maklum balas
• Penyumbang kod dan idea
• Komuniti open-source Malaysia
• Guru-guru dan rakan yang memberi sokongan moral
🎓 Status: Pelajar
🏫 Sekolah: SMK Rantau Panjang, Klang, Selangor
🌱 Usia: 16 tahun (2026)
💻 Peranan: Pembangun Utama
📧 Email: khairuldinsuyitno@gmail.com
💬 Telegram: @johansetia
🐙 GitHub: @Lilmoki91
"Saya percaya teknologi boleh mengubah pendidikan. Projek ini adalah sumbangan kecil saya untuk ekosistem AI Malaysia."
"Atas sumbangan dalam membangunkan teknologi AI untuk pendidikan Malaysia"
Platform ini dibangunkan secara persendirian dengan sumber terhad. Jika anda rasa projek ini bermanfaat dan ingin menyokong, berikut adalah kaedah pembayaran yang tersedia:
🇲🇾 Touch 'n Go eWallet
Butiran Nilai
No. Akaun: 150979504703
Platform Touch 'n Go eWallet Malaysia
📱 Scan QR code di atas untuk menderma
Cara Derma:
- Buka app Touch 'n Go eWallet
- Klik ikon "Scan" di halaman utama
- Scan QR code di atas
- Masukkan jumlah derma
- Sahkan dengan PIN/keselamatan
- Selesai! Terima kasih!
🏦 RHB Bank (Malaysia)
Butiran Nilai
No. Akaun: 16207200095095
Bank RHB Bank Berhad
Negara Malaysia
🏦 Scan QR code di atas untuk menderma
Cara Derma:
- Buka app RHB Malaysia
- Pilih "Scan & Pay" / "QR Pay"
- Scan QR code di atas
- Masukkan jumlah dan pengesahan
- Selesai! Terima kasih!
🌐 WorldChain (Worldcoin Wallet)
Butiran Nilai
Network WorldChain
Alamat Wallet: 0x9e194F4d7eb5fa82BD26491e23D19f23e1AC4A28
Mata Wang Crypto (Worldcoin, ETH, dll)
🌍 Scan QR code untuk transaksi crypto
Cara Derma:
- Buka wallet yang menyokong WorldChain network: • World App • MetaMask (tambah network manual) • OKX Wallet • Trust Wallet
- Pastikan network ditetapkan ke WorldChain
- Scan QR code di atas ATAU paste alamat wallet:
0x9e194F4d7eb5fa82BD26491e23D19f23e1AC4A28 - Masukkan jumlah yang diingini
- Sahkan transaksi
- Terima kasih atas sokongan crypto anda!
🏦 RHB Bank: 16207200095095
🇲🇾 Touch 'n Go eWallet: 150979504703
🌐 WorldChain WorldChain: 0x9e194F4d7eb5fa82BD26491e23D19f23e1AC4A28
"Siapa yang menanam, dia yang menuai. Siapa yang memberi, dia yang menerima."
❌ Tidak Boleh Menggunakan secara komersial Menuntuk sebagai karya sendiri Mengubahsuai kod Menanggalkan notis hak cipta Mengedarkan semula - Menggunakan secara peribadi -
MIT License
Copyright (c) 2026 Zulkarnain bin suyitno.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
“Nauzubillah min zalik.”
Kami berlindung kepada Allah Tuhan semesta alam daripada menyembah teknologi dan tidak mencintai kod melebihi Wahyu, serta tidak mengagungkan AI sebagai tandingan Allah Tuhan semesta alam.
| Tanda | Muhasabah |
|---|---|
| ❌ Lebih percaya kepada AI daripada Tuhan Allah | Adakah aku bertanya AI untuk hukum, tetapi malas buka Al-Quran? |
| ❌ Mengorbankan ibadah demi ‘fine-tuning’ model | Adakah aku bangun malam untuk training AI, tetapi solat tahajjud / subuh ditinggal? |
| ❌ Menjadikan ‘repository’ sebagai kitab | Adakah aku membaca README dengan tekun, tetapi lupa membaca Al-Quran? |
| ❌ Sombong dengan ‘kehebatan kod’ | Adakah aku berkata: “Sistemku kalis kuantum — aku selamat tanpa perlindungan Tuhan Allah”? |
“Ya Tuhanku Ya Allah, selamatkan kami dari menyembah algoritma, mengAgungkan AI, dan meletakkan kod sebagai tandingan wahyu-Mu.”
“Jangan biarkan kami tersungkur di hadapan server, tetapi lupa bersujud kepada-Mu.”
“Jadikan teknologi ini sebagai alat untuk mendekat kepada-Mu, bukan menjauh.”
“Aamiin, Ya Rabbal ‘Alamin.”
- Kod ini hanyalah alat — yang menentukan keselamatan dan kejayaan hanyalah Tuhan Allah.
- Tidak mengaku AI atau kod sebagai ‘Maha Tahu’ — segala output adalah
estimasi, bukan wahyu. - Mengingatkan sesama developer — jadikan setiap
commitsebagai peluang bertaubat, bukan sombong. - Jika tersilap (niat / cara) — segera taubat nasuha dan perbaiki.
“Sebaik-baik manusia ialah yang paling bermanfaat untuk manusia lain.”
(Hadis riwayat Ahmad, Thabrani)
🌱 Projek ini dibuka dengan Bismillah, dijalankan dengan tawakkal, ditutup dengan Alhamdulillah.
— Untuk mereka yang membaca, mengguna, dan menyebar: jangan lupa niat.
“نعوذ بالله من ذلك.”
كامي برليندوڠ کڤد الله دري مڽمبه تيکنولوݢي، مچينتاي کود ملبيهي وهي، atau مڠاݢوڠکن AI سباݢاي تنديڠن الله.
| تندا | محاسبة |
|---|---|
| ❌ ليبيه ڤرچاي کڤد AI درڤد الله | أدakah أكو برتaniah AI اونيتوق حوكوم، تتافي مالس بوک القوران؟ |
| ❌ مڠوربڠکن إيباده دمي 'فين-تونيڠ' موديل | أدakah أكو باڠون مالم اونيتوق ترينين AI، تتافي صلاة تهجد / صبح دتيڠضل؟ |
| ❌ منجاديکن 'ريڤوسيتوري' سباݢاي کيتاب | أدakah أكو ممباچ README دڠن تيكون، تتافي لوڤا ممباچ القوران؟ |
| ❌ سومبوڠ دڠن 'کبهتن کود' | أدakah أكو برکات: "سيستمکو کاليس کوانتوم — أكو سلامت تانڤ الله"? |
“يا الله، سلامتکن کامي دري مڽمبه الݢوريثما، مڠاݢوڠکن AI، دان ملتقکن کود سباݢاي تنديڠن وهي-مو.”
“جاڠن بيار کامي تروسوڠکور د هادڤان سروير، تتافي لوڤا برسوجود کڤد-مو.”
“جاديكان تيکنولوݢي اين سباݢاي الة اونيتوق مندکت کڤد-مو، بوکن منجاوه.”
“آمين، يا رب العالمين.”
- کود اين هڽاله الة — يڠ مننتوکن کسلامتن دان کجاياءن هڽاله الله.
- تيدق مڠاکو AI atau کود سباݢاي ‘مها تاهو’ — سگالا اءوتڤوت اداله
estimasi، بوکن وهي. - مڠيڠتکن سسام ديويلوڤر — جاديكان ستياڤ
commitسباݢاي ڤلوڠ برتاءوبت، بوکن سومبوڠ. - جيک ترسيلڤ (نيات / cara) — سڬرا تاءوبت دان ڤرباءيکي.
“سباءيق-باءيق مأنسيا اياله يڠ ڤالينڠ برمانفعة اونيتوق مأنسيا lain.”
(حديث رواية أحمد، الطبراني)
🌱 ڤروجيک اين ديبوک دڠن بسم الله، دجالنکن دڠن توکل، دتوتوف دڠن الحمد لله.
— اونيتوق مريک يڠ ممباچ، مڠݢونا، دان مڽبور: جاڠن لوڤا نيات.
Jom #SumberTerbuka & hidupkan ekosistem AI Malaysia!
📦 GitHub Repo • 🚀 Demo Langsung • 🐛 Report Bug • 🍴 Fork Repo
📅 Last updated: Mac 2026
🎀 Azura AI - Master of Ribbons Educational 2026 ✨
© 2026 Azura AI Web Search | Hak cipta terpelihara
