PHPackages aranus-tech/chatbot - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. aranus-tech/chatbot ActiveLibrary[Utility & Helpers](/categories/utility) aranus-tech/chatbot =================== Plug-and-play Laravel chatbot package — Minara AI widget, Live Chat handover, and RAG Knowledge Base dashboard. v1.0.0(2mo ago)00↓90.9%MITHackPHP ^8.1 Since Apr 15Pushed 1mo agoCompare [ Source](https://github.com/aranustech/plugin-chatbot-aranus)[ Packagist](https://packagist.org/packages/aranus-tech/chatbot)[ RSS](/packages/aranus-tech-chatbot/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (3)Versions (2)Used By (0) Aranus Chatbot — Minara AI ========================== [](#aranus-chatbot--minara-ai) [![Latest Version on Packagist](https://camo.githubusercontent.com/868c9d8f35da319158a0a53c6a9a7968aecde6fe3e30b6b1feb090853c68e3c2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6172616e75732d746563682f63686174626f742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aranus-tech/chatbot)[![Total Downloads](https://camo.githubusercontent.com/c57ce91552b24875a551c4cee92b5bf8c3d72c932d0a7e927cd41b62b5338d08/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6172616e75732d746563682f63686174626f742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aranus-tech/chatbot)[![License](https://camo.githubusercontent.com/3cfd7a1989ce6e157134b95e44722e0c0cec678655e1ad4f4153dd2cf15488ef/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6172616e75732d746563682f63686174626f742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aranus-tech/chatbot) Package Laravel untuk mengintegrasikan chatbot AI **Minara**, sistem **Live Chat Handover** ke admin, dan **RAG Knowledge Base** ke website Laravel mana saja secara *plug-and-play*. --- Fitur ----- [](#fitur) - 🤖 **Minara AI Widget**: Chatbot cerdas berbasis AI yang siap membantu pengunjung website 24/7. - 👨‍💼 **Human-in-the-Loop (Live Chat)**: Fitur oper alih percakapan dari AI ke Admin secara *real-time* menggunakan WebSocket. - 📚 **RAG Knowledge Base**: Latih AI Minara dengan mengunggah dokumen (PDF, TXT, Excel, Docx) langsung dari dashboard. - 🔍 **Dataset Viewer**: Pantau teks yang berhasil diekstraksi dan dipelajari oleh AI dari dokumen yang diunggah. - 📝 **Advanced Chat Logs**: Rekaman riwayat obrolan yang terpisah antara interaksi AI dan Admin dengan filter rentang tanggal. - 🔍 **Dataset Viewer**: Pantau konten teks yang berhasil diekstraksi dan dipelajari oleh AI. - 📝 **Advanced Chat Logs**: Riwayat percakapan lengkap yang dipisahkan antara interaksi AI dan Admin. - 🎨 **UI Isolation**: Menggunakan *pre-compiled CSS* sehingga tampilan chatbot tetap konsisten tanpa merusak desain website asli klien (tidak memerlukan Tailwind di aplikasi utama).--- Persyaratan ----------- [](#persyaratan) - PHP `^8.1` - Laravel `^10.0 | ^11.0 | ^12.0` - Database MySQL / PostgreSQL / SQLite --- Instalasi --------- [](#instalasi) ### 1. Install via Composer [](#1-install-via-composer) ``` composer require aranus-tech/chatbot ``` ### 2. Jalankan perintah install [](#2-jalankan-perintah-install) Perintah ini menerbitkan file konfigurasi (`config/chatbot.php`) dan aset CSS/ikon ke folder `public/vendor/chatbot`: ``` php artisan chatbot:install ``` ### 3. Jalankan migrasi [](#3-jalankan-migrasi) Package secara otomatis mendaftarkan 2 tabel yang dibutuhkan: ``` php artisan migrate ``` --- Konfigurasi ----------- [](#konfigurasi) ### 1. Environment variables (`.env`) [](#1-environment-variables-env) Tambahkan variabel berikut ke file `.env` project Anda: ``` # WebSocket AI dan Admin CHATBOT_WS_URL="wss://aranus-aranus-chatbot-plugin.hf.space/ws/chat" CHATBOT_ADMIN_WS_URL="wss://aranus-aranus-chatbot-plugin.hf.space/ws/admin" # Endpoint upload dokumen ke AI server CHATBOT_UPLOAD_URL="https://aranus-aranus-chatbot-plugin.hf.space/upload" # Email yang menerima notifikasi saat pengunjung minta Live Chat ADMIN_NOTIFICATION_EMAIL="admin@example.com" ``` ### 2. Konfigurasi dashboard (`config/chatbot.php`) [](#2-konfigurasi-dashboard-configchatbotphp) Setelah `chatbot:install`, edit `config/chatbot.php` agar sesuai dengan struktur aplikasi Anda: ``` return [ // Nama layout Blade utama aplikasi Anda // Halaman dashboard chatbot akan di-extend dari layout ini 'layout' => 'layouts.app', // Prefix URL untuk semua halaman dashboard chatbot // Contoh: 'dashboard' -> /dashboard/chatlog, /dashboard/live-chat, dst. 'prefix' => 'dashboard', // Middleware yang melindungi halaman dashboard chatbot 'middleware' => ['web', 'auth'], ]; ``` --- Penggunaan ---------- [](#penggunaan) ### Widget Chatbot (Frontend) [](#widget-chatbot-frontend) Tambahkan baris berikut ke layout utama website Anda (misalnya `resources/views/layouts/app.blade.php`): ``` {{-- CSS widget chatbot --}} {{-- Konten website Anda --}} {{-- Widget chatbot — letakkan sebelum --}} @chatbot ``` Widget akan muncul sebagai tombol mengambang di pojok kanan bawah halaman. --- ### Dashboard Admin [](#dashboard-admin) Package mendaftarkan rute dashboard secara otomatis berdasarkan `prefix` dan `middleware` di `config/chatbot.php`. Tambahkan tautan berikut ke sidebar navigasi admin Anda: ``` Chat Log Live Chat Knowledge Base Dataset ``` **Daftar lengkap named routes:** Route NameMethodURL (default prefix: `dashboard`)Deskripsi`chatbot.index`GET`/dashboard/chatlog`Riwayat percakapan AI & Admin`chatbot.livechat`GET`/dashboard/live-chat`Dashboard Live Chat admin`chatbot.kb`GET`/dashboard/knowledge-base`Upload & kelola dokumen AI`chatbot.kb.upload`POST`/dashboard/knowledge-base/upload`Upload dokumen`chatbot.kb.sync`POST`/dashboard/knowledge-base/sync`Sinkronisasi ulang ke AI server`chatbot.kb.toggle`POST`/dashboard/knowledge-base/toggle/{id}`Aktifkan/nonaktifkan dokumen`chatbot.kb.destroy`DELETE`/dashboard/knowledge-base/{id}`Hapus dokumen`chatbot.kb.dataset`GET`/dashboard/knowledge-base/dataset`Lihat teks hasil ekstraksi**Endpoint API publik (digunakan oleh widget secara internal):** Route NameMethodURLDeskripsi`chatbot.store`POST`/aranus-chatbot/store-chat`Simpan percakapan AI`chatbot.store.admin`POST`/aranus-chatbot/store-admin-chat`Simpan percakapan admin`chatbot.notify.handover`POST`/aranus-chatbot/notify-admin-handover`Kirim email notifikasi handover`chatbot.popular`GET`/aranus-chatbot/popular-questions`Ambil pertanyaan populer--- ### Kustomisasi Tampilan [](#kustomisasi-tampilan) Jika ingin mengubah tampilan halaman dashboard, publish view-nya terlebih dahulu: ``` php artisan vendor:publish --tag=chatbot-views ``` File view akan disalin ke `resources/views/vendor/chatbot/`. Setelah itu Anda bisa mengedit bebas tanpa mempengaruhi package aslinya. --- Struktur Tabel Database ----------------------- [](#struktur-tabel-database) ### `chat_records` [](#chat_records) KolomTipeKeterangan`id`bigintPrimary key`session_code`stringKode sesi unik pengunjung`type`enum('ai','admin')Jenis percakapan`client_message`textPesan dari pengunjung`ai_message`textBalasan dari AI (nullable)`admin_message`longtextJSON array percakapan admin (nullable)`waktu`datetimeWaktu percakapan### `knowledge_documents` [](#knowledge_documents) KolomTipeKeterangan`id`bigintPrimary key`title`stringJudul dokumen`original_name`stringNama file asli`filename`stringNama file tersimpan`file_path`stringPath di storage`file_size`bigintUkuran file (bytes)`file_type`stringEkstensi file`content`longtextTeks hasil ekstraksi AI (nullable)`status`enum('active','inactive')Status aktif/nonaktif`sync_status`enum('pending','synced','failed')Status sinkronisasi ke AI server`uploaded_by`stringNama admin yang upload--- Publish Aset Secara Manual -------------------------- [](#publish-aset-secara-manual) Jika perlu menerbitkan aset secara terpisah: ``` # Konfigurasi php artisan vendor:publish --tag=chatbot-config # Aset CSS & ikon (wajib untuk widget) php artisan vendor:publish --tag=chatbot-assets # View (opsional, untuk kustomisasi tampilan) php artisan vendor:publish --tag=chatbot-views ``` --- ### Health Score 36 — LowBetter than 79% of packages Maintenance87 Actively maintained with recent releases Popularity0 Limited adoption so far Community9 Small or concentrated contributor base Maturity42 Maturing project, gaining track record Bus Factor1 Top contributor holds 52.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 78d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/66f39d8089f85cdb4e2f734dfd5d3fc97428baa8b7368c5fd8ab9bc63dc3b2da?d=identicon)[FarhanSuryadicka](/maintainers/FarhanSuryadicka) --- Top Contributors [![FarhanSuryadicka](https://avatars.githubusercontent.com/u/174685281?v=4)](https://github.com/FarhanSuryadicka "FarhanSuryadicka (9 commits)")[![Chicktickhack](https://avatars.githubusercontent.com/u/202151207?v=4)](https://github.com/Chicktickhack "Chicktickhack (6 commits)")[![likeazwee](https://avatars.githubusercontent.com/u/145989523?v=4)](https://github.com/likeazwee "likeazwee (2 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/aranus-tech-chatbot/health.svg) ``` [![Health](https://phpackages.com/badges/aranus-tech-chatbot/health.svg)](https://phpackages.com/packages/aranus-tech-chatbot) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed Laravel Page Speed 2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[illuminate/pagination The Illuminate Pagination package. 12234.1M1.0k](/packages/illuminate-pagination)[illuminate/pipeline The Illuminate Pipeline package. 9349.2M277](/packages/illuminate-pipeline)[illuminate/broadcasting The Illuminate Broadcasting package. 7127.2M208](/packages/illuminate-broadcasting)[illuminate/redis The Illuminate Redis package. 8314.6M369](/packages/illuminate-redis) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)