KChat 💬

AI chatbot CLI toolkit — Chatea con IA desde la terminal, con modo demo offline y proveedores reales (OpenAI-compatible).

By @javifriasj · mismo autor que KScan y KLogLib

Instalación

pip install kchat

Uso rápido (modo demo)

Sin API key, KChat responde con un proveedor mock ideal para probar el CLI y la demo del portfolio:

kchat ask "Hola, ¿qué puedes hacer?"
kchat models
kchat config show

Comandos

kchat ask — Pregunta en una sola línea

kchat ask "Explica qué es asyncio en Python"

kchat ask "Resume este error" --provider openai --model gpt-4o-mini

kchat chat — Conversación interactiva

kchat chat
# escribe mensajes; `exit` o Ctrl+C para salir

kchat models — Modelos disponibles

kchat models

kchat config show — Variables de entorno

kchat config show

Proveedor real (OpenAI-compatible)

export KCHAT_PROVIDER=openai
export KCHAT_API_KEY=sk-...
export KCHAT_MODEL=gpt-4o-mini
# opcional: export KCHAT_BASE_URL=https://api.openai.com/v1

kchat ask "¿Cómo estructuro un paquete Python?"

Desarrollo local

git clone https://github.com/javifriasj/kchat
cd kchat
pip install -e ".[dev]"
pytest

Licencia

MIT © Javier Frías Jiménez