--- 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 ![meow](https://cdn-uploads.huggingface.co/production/uploads/699872ccaf89b7c1a5351ff9/xR-fIA_DnXbkrgNb7yON8.png) 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. ---