K-CHAT — Mesin Chatbot Universal. Anti-halusinasi bawaan. Cukup taruh folder data.
Project description
K-CHAT — Mesin Chatbot Universal
Anti-halusinasi bawaan. Cukup taruh folder data. Jadi chatbot. Tanpa ribet.
Pilih Model
| Model | Cocok | Cara |
|---|---|---|
| A — Hosted | UMKM, website shared hosting | Upload zip → copas widget |
| C — Self-Hosted | Developer, project Python | pip install atau copy engine/ |
Model A: Hosted (copas widget)
<div id="kchat-widget"></div>
<script src="https://k-studio.my.id/api/widget.js?key="></script>
Upload data bisnis Anda via admin panel. Dapat API key + widget script.
Model C: Self-Hosted (CLI / copy engine)
pip install kstudiochat
kstudiochat init ./bot --template restaurant
kstudiochat chat --data ./bot
Atau copy folder engine/ ke project Python Anda → from engine import Bot
Selengkapnya: docs/PILIHAN_MODEL.md
Mulai Cepat
# Install
pip install kstudiochat
# Buat bot dari template
kstudiochat init ./bot --template pemerintah
# Chat (pake SimulatedLLM — offline, tanpa API key)
kstudiochat chat --data ./bot
# Atau pake LLM sungguhan
pip install kstudiochat[openai]
# Edit bot/config.json → llm.provider: "openai" | "deepseek" | "mimo"
Template
| Template | Deskripsi |
|---|---|
government |
FAQ pelayanan publik, perizinan, pajak |
restaurant |
Menu, jam buka, reservasi |
healthcare |
Info kesehatan umum, FAQ klinik |
Cara Kerja
Taruh folder. Dapat chatbot. Tidak perlu kode.
bot-ku/
├── config.json # Identitas bot, LLM provider, dll
├── knowledge/ # Dokumen yang dijawab bot
│ ├── faq.md
│ └── harga.md
├── SOUL.md # Kepribadian (opsional)
├── intents.json # Kata kunci intent (opsional)
└── refusal.json # Pesan fallback (opsional)
Pipeline
User → Sanitasi → Etika → Intent → Kirim SEMUA data → LLM → Verifikasi → Respon
Tiga gate dalam satu prompt:
- Gate 1 — Salam/terima kasih → LLM tanpa data (balas natural)
- Gate 2 — Pertanyaan → LLM dengan semua data
- Gate 3 — Di luar topik → Tolak sopan, arahkan ke topik relevan
Anti-Halusinasi
- Prompt "jawab hanya dari DATA"
- Deteksi penolakan: tangkap "saya tidak tahu"
- Verifikasi: entity consistency + overlap check
- Etika: blokir konten berbahaya
Provider LLM
| Provider | Model | Konfigurasi |
|---|---|---|
| Simulated (built-in, offline) | simulated |
Default — tanpa setup |
| OpenAI | gpt-4o-mini |
Set OPENAI_API_KEY |
| DeepSeek | deepseek-v4-flash |
Set DEEPSEEK_API_KEY |
| Xiaomi MiMo | mimo-v2-flash |
Set MIMO_API_KEY |
"llm": {"provider": "mimo", "model": "mimo-v2-flash", "temperature": 0.3}
Referensi CLI
| Perintah | Deskripsi |
|---|---|
kstudiochat init <path> |
Buat pack baru |
kstudiochat init <path> --template <nama> |
Buat dari template |
kstudiochat templates |
Lihat template |
kstudiochat chat --data <path> |
Chat interaktif |
kstudiochat serve --data <path> |
REST API server |
kstudiochat validate --data <path> |
Validasi pack |
kstudiochat info --data <path> |
Lihat konfigurasi |
API Multi-Tenant (untuk klien)
K-CHAT bisa jalan sebagai API multi-tenant — klien upload data, dapet endpoint chatbot.
Endpoint
| Method | Path | Deskripsi |
|---|---|---|
POST |
/api/packs |
Upload zip → dapet API key |
POST |
/api/chat |
Chat dengan bot |
DELETE |
/api/packs/:id |
Hapus pack |
GET |
/api/widget.js?key=xxx |
Script widget |
Cara embed (hosting manapun)
<div id="kchat-widget"></div>
<script src="https://url-api-anda/api/widget.js?key=kc_xxx"></script>
Contoh lengkap: lihat example-widget.html
Langsung pake API
curl -X POST https://url-api-anda/api/chat \
-H "Authorization: Bearer kc_xxx" \
-H "Content-Type: application/json" \
-d '{"message": "Berapa jam buka?"}'
Ekstensi
Diaktifkan via config.json:
"extensions": {
"conversational_memory": {"enabled": true},
"predictive": {"enabled": true}
}
| Ekstensi | Fungsi |
|---|---|
conversational_memory |
Catat preferensi user, mood |
multimodal |
Deteksi emosi lebih akurat |
predictive |
Deteksi interaksi berisiko |
live |
Data real-time (harga, antrian) |
adaptive |
Pantau efektivitas strategi |
rlhf |
Kumpulkan feedback |
voice |
STT → chat → TTS |
Kenapa K-CHAT?
| Dibanding... | K-CHAT kasih lo |
|---|---|
| LangChain | Cukup taruh folder, tanpa kode |
| Bikin dari nol | Anti-halusinasi siap pakai |
| SaaS chatbot ($30+/bln) | Sekali deploy, gratis seterusnya |
| Pipeline ML | Verifikasi deterministik, teraudit |
Lisensi
MIT
Dokumentasi: Panduan | Pilihan Model | Arsitektur
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kstudiochat-1.3.3.tar.gz.
File metadata
- Download URL: kstudiochat-1.3.3.tar.gz
- Upload date:
- Size: 114.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f31bdcbf7585b70f6bff9a08c68c4f0b37d8fe13da7e588114b64ab38e57358
|
|
| MD5 |
e678167fa895586c058bad0be7c7df22
|
|
| BLAKE2b-256 |
0563e082d9cec4054888d9c04ffeebdd6cf6c8cd5755898df6c0fd7f163804ab
|
File details
Details for the file kstudiochat-1.3.3-py3-none-any.whl.
File metadata
- Download URL: kstudiochat-1.3.3-py3-none-any.whl
- Upload date:
- Size: 110.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
940925305b119cda1c6e671d62cca28bbc2404ca2787bd41d417977c52d3b023
|
|
| MD5 |
8597d240270a16cb42eca7c08186806c
|
|
| BLAKE2b-256 |
0c59dfd43fb2a5b086815e57c91163fa05ebff921adfa11e131e7c8a1d553469
|