Metadata-Version: 2.4
Name: kchat
Version: 0.1.0
Summary: AI chatbot CLI toolkit for developers — chat, sessions, and pluggable LLM providers
Author-email: Javier Frías Jiménez <javifriasj@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/javifriasj/kchat
Project-URL: Repository, https://github.com/javifriasj/kchat
Project-URL: Issues, https://github.com/javifriasj/kchat/issues
Keywords: cli,chatbot,ai,llm,openai,developer-tools
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12
Requires-Dist: rich>=13.0
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

# KChat 💬

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

By [@javifriasj](https://github.com/javifriasj) · mismo autor que [KScan](https://github.com/javifriasj/kscan) y [KLogLib](https://github.com/javifriasj/KLog)

---

## Instalación

```bash
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:

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

---

## Comandos

### `kchat ask` — Pregunta en una sola línea

```bash
kchat ask "Explica qué es asyncio en Python"

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

### `kchat chat` — Conversación interactiva

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

### `kchat models` — Modelos disponibles

```bash
kchat models
```

### `kchat config show` — Variables de entorno

```bash
kchat config show
```

---

## Proveedor real (OpenAI-compatible)

```bash
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

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

---

## Licencia

MIT © [Javier Frías Jiménez](https://github.com/javifriasj)
