NekoPal Settings UI Fix

Patch ini memperbaiki halaman Settings yang terpotong:

• panel diperbesar;
• halaman Settings bisa di-scroll;
• tombol dan status bagian bawah tidak terpotong;
• koneksi LM Studio diberi timeout 8 detik.

Pasang

python .\apply_settings_ui_fix.py
python -m py_compile .\main.py
python .\main.py

Pastikan LM Studio menampilkan Status: Running sebelum menekan Refresh Models.

---

Local AI Setup with LM Studio

NekoPal menggunakan model AI lokal melalui LM Studio. Fitur Chat tidak membutuhkan OpenAI API key atau billing API.

Model AI tidak disertakan di dalam repository karena ukuran file model dapat mencapai beberapa gigabyte. Setiap pengguna perlu mengunduh model sendiri melalui LM Studio.

1. Install LM Studio

Install LM Studio untuk Windows.

Aplikasi dan model dapat disimpan di drive yang memiliki ruang kosong lebih besar. Contoh:

D:\LM STUDIO
D:\LM Studio Models

Untuk mengubah lokasi model:

1. Buka halaman My Models.
2. Lihat lokasi model di pojok kanan bawah.
3. Klik kotak lokasi atau tombol ....
4. Pilih folder model yang diinginkan.

2. Download a Local Model

Buka halaman Discover di LM Studio, lalu cari:

mistralai/ministral-3-3b

Gunakan versi Instruct, bukan versi Reasoning.

Konfigurasi yang telah digunakan selama pengembangan NekoPal:

Model: ministral-3-3b-instruct-2512
Format: GGUF
Quantization: Q4_K_M

Klik Download dan tunggu sampai selesai.

Model alternatif dapat digunakan selama mendukung chat dan tersedia melalui server lokal LM Studio.

3. Load the Model

Setelah download selesai:

1. Klik Select a model to load.
2. Pilih model yang telah diunduh.
3. Gunakan pengaturan load default terlebih dahulu.
4. Tunggu hingga model berstatus:

READY

Tes model langsung melalui halaman Chat LM Studio:

Halo, jawab singkat dalam Bahasa Indonesia.

4. Start the Local Server

Buka:

Developer → Local Server

Pastikan model sudah berstatus READY.

Klik toggle di samping:

Status: Stopped

Status harus berubah menjadi:

Status: Running

Alamat server default LM Studio:

http://127.0.0.1:1234

Endpoint yang digunakan NekoPal:

http://127.0.0.1:1234/v1

LM Studio harus tetap terbuka dan Local Server harus tetap berjalan selama fitur Chat NekoPal digunakan.

5. Connect NekoPal

Jalankan NekoPal:

python .\main.py

Kemudian:

1. Double-click pet untuk membuka panel.
2. Buka Settings.
3. Isi alamat LM Studio server:

http://127.0.0.1:1234/v1

4. Klik Refresh Models.
5. Pilih model lokal yang muncul.
6. Klik Test Connection.
7. Klik Save Settings.
8. Buka halaman Chat.

Troubleshooting

Model tidak muncul di NekoPal

Pastikan:

• LM Studio masih terbuka.
• Model sudah di-load dan berstatus READY.
• Local Server berstatus Running.
• Alamat server di NekoPal menggunakan /v1.

Kemudian klik kembali Refresh Models.

Tombol Refresh Models terus menghubungkan

Periksa status server di LM Studio. Server harus berstatus Running, bukan Stopped.

Chat tidak menjawab

Pastikan model belum di-eject dan LM Studio tidak ditutup. Coba kirim pesan langsung melalui Chat LM Studio untuk memastikan model dapat melakukan inferensi.

Respons lambat

Gunakan model sekitar 3B dengan quantization Q4_K_M. Tutup aplikasi lain yang menggunakan banyak GPU atau RAM.

Apakah internet selalu diperlukan?

Internet diperlukan saat mengunduh LM Studio dan model. Setelah model tersedia, proses chat dapat berjalan lokal tanpa mengirim pesan ke OpenAI API.

Privacy

Pesan Chat NekoPal dikirim ke server LM Studio yang berjalan pada komputer pengguna sendiri. NekoPal tidak membutuhkan OpenAI API key.

Important

Jangan memasukkan file model .gguf ke repository GitHub. File model berukuran besar dan harus diunduh oleh masing-masing pengguna melalui LM Studio.