| --- |
| license: mit |
| datasets: |
| - Qwen/DeepPlanning |
| language: |
| - id |
| metrics: |
| - accuracy |
| base_model: |
| - Qwen/Qwen3-Coder-Next |
| new_version: Qwen/Qwen3.5-397B-A17B |
| pipeline_tag: text-classification |
| library_name: adapter-transformers |
| tags: |
| - HummanAI |
| - Model |
| - .gguf |
| - Cyber |
| - Scurity |
| --- |
| |
| # 🐱💻 HackCat AI Chat |
|
|
|  |
|
|
| <audio controls src="https://cdn-uploads.huggingface.co/production/uploads/699872ccaf89b7c1a5351ff9/59VOoSNjxHRxhKaWEYZB_.mpga"></audio> |
|
|
| HackCat AI Chat adalah aplikasi chatbot berbasis Command Line Interface (CLI) yang berjalan menggunakan model bahasa lokal (Large Language Model) berekstensi `.gguf`. Proyek ini menggunakan pustaka `gpt4all` dan dirancang untuk berjalan **sepenuhnya secara offline** tanpa memerlukan koneksi internet. |
|
|
| ## ✨ Fitur Utama |
|
|
| * **100% Offline:** Menjaga privasi data Anda karena pemrosesan dilakukan sepenuhnya di perangkat lokal. |
| * **Streaming Responses:** Jawaban dari AI ditampilkan kata demi kata secara *real-time*, memberikan pengalaman obrolan yang natural. |
| * **Sesi Interaktif:** Mengingat konteks percakapan selama sesi berjalan. |
|
|
| --- |
|
|
| ## 🛠️ Persyaratan Sistem (Prerequisites) |
|
|
| Sebelum menjalankan aplikasi ini, pastikan sistem Anda telah memenuhi persyaratan berikut: |
|
|
| 1. **Python** versi 3.8 atau lebih baru. |
| 2. Pustaka Python **GPT4All**. |
| 3. File model GGUF bernama `Model_Bahasa_Ram 2.gguf`. |
|
|
| --- |
|
|
| ## 🚀 Cara Instalasi & Persiapan |
|
|
| **1. Install Library GPT4All** |
| Buka terminal/command prompt Anda dan jalankan perintah berikut: |
|
|
| ```bash |
| pip install gpt4all |
| |
| ``` |
|
|
| **2. Persiapkan File Model** |
| Karena aplikasi ini disetel untuk tidak mengunduh model secara otomatis (`allow_download=False`), Anda harus menyediakan file modelnya secara manual: |
|
|
| * Unduh atau siapkan file model `Model_Bahasa_Ram 2.gguf`. |
| * Buat folder bernama `model` di direktori yang sama dengan file script Python Anda. |
| * Pindahkan file `.gguf` tersebut ke dalam folder `model`. |
|
|
| **3. Struktur Direktori** |
| Pastikan struktur folder Anda terlihat seperti ini: |
|
|
| ```text |
| 📦 Proyek_HackCat/ |
| ┣ 📂 model/ |
| ┃ ┗ 📜 Model_Bahasa_Ram 2.gguf |
| ┗ 📜 main.py (File script Python Anda) |
| |
| ``` |
|
|
| --- |
|
|
| ## 💻 Cara Menjalankan Aplikasi |
|
|
| 1. Buka terminal/command prompt. |
| 2. Arahkan ke direktori proyek Anda. |
| 3. Jalankan script Python: |
|
|
| ```bash |
| python main.py |
| |
| ``` |
|
|
| *(Ganti `main.py` dengan nama file Python Anda yang sebenarnya).* |
|
|
| Setelah berjalan, Anda akan melihat tampilan seperti ini di terminal: |
|
|
| ```text |
| === HackCat AI Chat === |
| (Ketik 'exit' untuk berhenti) |
| |
| Kamu: Halo, apa kabar? |
| AI: Halo! Kabar saya baik. Ada yang bisa saya bantu hari ini? |
| |
| ``` |
|
|
| Ketik **`exit`** kapan saja untuk menghentikan program dan keluar dari sesi obrolan. |
|
|
| --- |
|
|
| ## ⚙️ Penjelasan Kode Singkat |
|
|
| * `model_path="./model/"`: Menentukan lokasi di mana program akan mencari file model. |
| * `allow_download=False`: Memaksa program untuk hanya menggunakan model yang sudah ada secara lokal. Jika file tidak ditemukan, program akan memunculkan *error* alih-alih mencoba mengunduhnya dari internet. |
| * `streaming=True`: Memungkinkan teks dicetak ke layar sedikit demi sedikit (efek mengetik) alih-alih menunggu seluruh kalimat selesai dibuat oleh AI. |
|
|
| --- |
|
|
| ## 🛠️ Panduan Troubleshooting (Pemecahan Masalah) |
|
|
| Jika Anda menemui kendala saat menjalankan **HackCat AI Chat**, silakan cek solusi di bawah ini: |
|
|
| ### 1. Model Not Found (File Tidak Ditemukan) |
|
|
| **Gejala:** Muncul pesan error `Model file not found` atau program langsung tertutup. |
|
|
| * **Solusi:** * Pastikan nama file di dalam folder `model` **sama persis** dengan yang ada di kode: `Model_Bahasa_Ram 2.gguf`. Perhatikan spasi dan huruf kapital. |
| * Pastikan path-nya benar. Jika Anda menjalankan script dari folder luar, gunakan path absolut atau pastikan folder `model/` berada satu level dengan script `.py`. |
|
|
|
|
|
|
| ### 2. Error: "Instruction set not supported" (AVX/AVX2) |
|
|
| **Gejala:** Program *crash* atau *error* saat inisialisasi model. |
|
|
| * **Penyebab:** GPT4All memerlukan instruksi CPU tertentu (AVX atau AVX2). Jika CPU Anda terlalu lama, ia mungkin tidak mendukung instruksi ini. |
| * **Solusi:** * Update driver chipset Anda. |
| * Pastikan Anda menggunakan versi `gpt4all` terbaru (`pip install --upgrade gpt4all`). |
| * Jika menggunakan CPU sangat tua, Anda mungkin perlu mencari *build* khusus atau mengganti perangkat. |
|
|
|
|
|
|
| ### 3. Masalah RAM & Performa (Lagging) |
|
|
| **Gejala:** Respon AI sangat lambat atau komputer menjadi tidak responsif. |
|
|
| * **Penyebab:** Model `.gguf` dimuat ke dalam RAM. Model yang besar membutuhkan RAM yang lega (minimal 8GB untuk performa stabil). |
| * **Solusi:** |
| * Tutup aplikasi berat lainnya (Chrome, Game, Video Editor) saat menjalankan AI. |
| * Gunakan model dengan ukuran parameter yang lebih kecil atau kuantisasi yang lebih tinggi (misal: versi `Q4_K_M`). |
|
|
|
|
|
|
| ### 4. Library Tidak Terdeteksi |
|
|
| **Gejala:** `ModuleNotFoundError: No module named 'gpt4all'` |
|
|
| * **Solusi:** Pastikan Anda menginstal library di lingkungan (environment) yang benar. Jika menggunakan Virtual Environment (venv), aktifkan dulu venv-nya sebelum menjalankan `pip install`. |
|
|
| ### 5. Karakter Aneh pada Output Streaming |
|
|
| **Gejala:** Muncul karakter kotak-kotak atau simbol aneh saat AI menjawab. |
|
|
| * **Solusi:** Ini biasanya masalah encoding pada Terminal/CMD. Gunakan terminal yang mendukung UTF-8 seperti **VS Code Terminal**, **Windows Terminal**, atau **PowerShell** (hindari CMD jadul jika memungkinkan). |
|
|
| --- |
|
|
| ## 📝 Tips Tambahan |
|
|
| * **Update Library:** Selalu gunakan versi terbaru dengan perintah `pip install -U gpt4all`. |
| * **Logs:** Jika error tetap berlanjut, hapus `allow_download=False` sementara untuk melihat apakah library mencoba mengunduh dependensi yang hilang. |
|
|
| --- |
