{"id":29287404,"url":"https://github.com/youngicom/simplechatailmstudio","last_synced_at":"2025-07-06T01:07:26.825Z","repository":{"id":299919723,"uuid":"1004635471","full_name":"youngIcom/SimpleChatAILMStudio","owner":"youngIcom","description":"simple_chat_with_local_model adalah program chatbot sederhana berbasis terminal yang dapat dijalankan di perangkat linux, dengan meload model pada sebuah server di LM Studio","archived":false,"fork":false,"pushed_at":"2025-06-19T00:37:13.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-19T01:29:10.574Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/youngIcom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-19T00:15:36.000Z","updated_at":"2025-06-19T00:37:17.000Z","dependencies_parsed_at":"2025-06-19T01:39:26.845Z","dependency_job_id":null,"html_url":"https://github.com/youngIcom/SimpleChatAILMStudio","commit_stats":null,"previous_names":["youngicom/simplechatailmstudio"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/youngIcom/SimpleChatAILMStudio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youngIcom%2FSimpleChatAILMStudio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youngIcom%2FSimpleChatAILMStudio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youngIcom%2FSimpleChatAILMStudio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youngIcom%2FSimpleChatAILMStudio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/youngIcom","download_url":"https://codeload.github.com/youngIcom/SimpleChatAILMStudio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youngIcom%2FSimpleChatAILMStudio/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263833416,"owners_count":23517374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-06T01:07:19.814Z","updated_at":"2025-07-06T01:07:26.796Z","avatar_url":"https://github.com/youngIcom.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Chat AI Lokal dengan Suara (TTS)\n\nSelamat datang di **Chat AI Lokal**!  \nSkrip Python sederhana ini memungkinkan kamu mengobrol dengan model AI langsung di komputermu sendiri. Tidak hanya membalas lewat teks, asisten AI ini juga bisa \"berbicara\" menggunakan Text-to-Speech (TTS).\n\n---\n\n## ✨ Fitur Unggulan\n\n- 💻 **100% Lokal \u0026 Privat:** Semua proses chat dan suara berjalan di mesin kamu. Aman, tanpa sensor.\n- 🗣️ **Output Suara Fleksibel:**\n  - **eSpeak-NG (Default):** Cepat, ringan, dan hemat sumber daya.\n  - **Coqui TTS (Opsional):** Suara lebih natural (butuh setup tambahan).\n- 🧠 **Kontekstual:** AI mengingat riwayat percakapan dalam satu sesi.\n- 🎨 **Tampilan Berwarna:** Terminal lebih hidup berkat `colorama`.\n- 🔌 **Mudah Dikonfigurasi:** Ubah beberapa variabel saja untuk menyesuaikan server AI dan model.\n- 🛠️ **Penanganan Error:** Pesan jelas jika gagal terhubung ke server AI atau ada masalah lain.\n\n---\n\n## 🔧 Prasyarat\n\nPastikan semua kebutuhan berikut sudah terpasang di sistem kamu:\n\n- **Python 3.7+**\n- **Server AI Lokal:**  \n  Contoh: LM Studio, Ollama, dll.  \n  \u003e **Pastikan sudah mengunduh model AI (misal: Llama 3, Mistral, dsb) dan menjalankan API Server.**\n- **Dependensi Sistem (untuk TTS):**\n  - **Linux (Debian/Ubuntu):**\n    ```bash\n    sudo apt-get update \u0026\u0026 sudo apt-get install espeak-ng aplay\n    ```\n  - **Windows/MacOS:**  \n    Instal eSpeak-NG secara manual.\n\n---\n\n## 🚀 Instalasi \u0026 Konfigurasi\n\n1. **Clone Repositori**\n    ```bash\n    git clone https://github.com/username-kamu/nama-repositori-kamu.git\n    cd nama-repositori-kamu\n    ```\n\n2. **Buat `requirements.txt`**\n    ```\n    requests\n    colorama\n    ```\n\n3. **Buat Virtual Environment (Opsional tapi direkomendasikan)**\n    ```bash\n    python -m venv venv\n    source venv/bin/activate  # Windows: venv\\Scripts\\activate\n    ```\n\n4. **Install Library Python**\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n5. **Konfigurasi Skrip Utama**\n    - Buka file Python utama.\n    - Ubah variabel berikut sesuai kebutuhan:\n      ```python\n      API_URL = \"http://127.0.0.1:1234/v1/chat/completions\"  # Ganti jika perlu\n      # ...\n      data = {\n          \"model\": \"nama-model-yang-kamu-pakai\",  # Sesuaikan dengan model di server AI\n          # ...\n      }\n      ```\n\n---\n\n## ▶️ Cara Menjalankan\n\nSetelah konfigurasi selesai, jalankan perintah berikut di terminal:\n\n```bash\npython nama_file_kamu.py\n```\n\nKamu bisa mulai mengobrol dengan AI lokalmu!  \nKetik `exit` atau `keluar` untuk mengakhiri sesi.\n\n---\n\n## 🔊 (Opsional) Suara Natural dengan Coqui TTS\n\nIngin suara AI yang lebih natural?  \nIkuti langkah berikut (butuh RAM/VRAM lebih besar):\n\n1. **Install Coqui TTS**\n    ```bash\n    pip install TTS\n    ```\n\n2. **Unduh Model Suara**  \n   (dari Hugging Face, dsb. Biasanya terdiri dari `checkpoint.pth`, `config.json`, dan `speakers.pth` jika multi-speaker)\n\n3. **Konfigurasi Skrip**\n    - Letakkan file model di folder skrip.\n    - Ubah path di skrip:\n      ```python\n      MODEL_FILE_PATH = \"checkpoint_1260000-inference.pth\"\n      CONFIG_FILE_PATH = \"config.json\"\n      SPEAKERS_FILE_PATH = \"speakers.pth\"  # Jika ada\n      SPEAKER_IDX = \"wibowo\"  # Sesuaikan dengan speaker yang tersedia\n      ```\n    - Aktifkan kode Coqui TTS di dalam loop `chat_with_ai`:\n      ```python\n      # Komentar baris espeak-ng\n      # subprocess.run('espeak-ng', ...)\n\n      # Aktifkan blok Coqui TTS\n      success, msg = synthesize_speech_coqui(\n          ai_response,\n          MODEL_FILE_PATH,\n          CONFIG_FILE_PATH,\n          OUTPUT_WAV,\n          speaker_idx=SPEAKER_IDX,\n          speakers_file=SPEAKERS_FILE_PATH\n      )\n      if success:\n          if os.path.exists(OUTPUT_WAV):\n              play_status = os.system(f'aplay {OUTPUT_WAV}')\n              if play_status != 0:\n                  print(f\"{Fore.RED}Error saat memutar audio...{Style.RESET_ALL}\")\n      ```\n\n4. **Jalankan kembali skrip**  \n   Jika konfigurasi benar, AI akan berbicara dengan suara lebih alami!\n\n---\n\n## 🤔 Troubleshooting\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eError: \u003ccode\u003erequests.exceptions.ConnectionError\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\n**Penyebab:** Skrip tidak bisa terhubung ke server AI.  \n**Solusi:**\n- Pastikan aplikasi server AI (LM Studio, dll.) sedang berjalan.\n- Pastikan sudah menekan tombol \"Start Server\".\n- Periksa kembali `API_URL` di skrip.\n- Cek firewall yang mungkin memblokir koneksi lokal.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eError: Perintah 'tts' tidak ditemukan (Coqui)\u003c/strong\u003e\u003c/summary\u003e\n\n**Penyebab:** Library Coqui TTS belum terinstal atau PATH tidak ditemukan.  \n**Solusi:**  \nPastikan berada di virtual environment yang benar, lalu jalankan:\n```bash\npip install TTS\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eSuara tidak berbunyi di Linux\u003c/strong\u003e\u003c/summary\u003e\n\n**Penyebab:** `aplay` belum terinstal.  \n**Solusi:**\n```bash\nsudo apt-get install alsa-utils\n```\n\u003c/details\u003e\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoungicom%2Fsimplechatailmstudio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyoungicom%2Fsimplechatailmstudio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoungicom%2Fsimplechatailmstudio/lists"}