Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kstudiochat-1.3.1.tar.gz (114.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kstudiochat-1.3.1-py3-none-any.whl (110.5 kB view details)

Uploaded Python 3

File details

Details for the file kstudiochat-1.3.1.tar.gz.

File metadata

  • Download URL: kstudiochat-1.3.1.tar.gz
  • Upload date:
  • Size: 114.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for kstudiochat-1.3.1.tar.gz
Algorithm Hash digest
SHA256 f23ac9989a430c3cb5b5eee7dc841848da0d2603ec370bd55c8f4e7c1a7b1bdf
MD5 f5d377633a4fa6ced22ba3eafd8446d1
BLAKE2b-256 0fd1c869e55826334c58b521922443fd0da95f8eaf9ab2a220ead72d74a9d487

See more details on using hashes here.

File details

Details for the file kstudiochat-1.3.1-py3-none-any.whl.

File metadata

  • Download URL: kstudiochat-1.3.1-py3-none-any.whl
  • Upload date:
  • Size: 110.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for kstudiochat-1.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7a3595f33bd0897e4ec2f0b3995eb8aaa61d30c5a0a376078fc3c96b156bd69a
MD5 a01833fcd67e41a8520ada176d84f0bf
BLAKE2b-256 0c98c984a63f5d0d17c0e1fa6bba1376963b4d3cedd00b6d8ce11346cf227d82

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page