Update README.md

🤖 Chatbot de Base de Conocimientos Configurable

Este proyecto es un chatbot interactivo construido con Gradio, diseñado para responder preguntas basándose en una base de conocimientos proporcionada en formato CSV, XLSX o PDF.

Además, permite configurar la personalidad del bot para adaptar su tono de respuesta.

CaracterísticasCarga de Base de Conocimientos: Soporte para archivos .csv, .xlsx y .pdf.

Personalidad Configurable: Elige entre personalidades como "amigable", "formal", "creativo" y "analítico".

Integración con Gemini API: Utiliza el modelo gemini-2.0-flash para generar respuestas.Interfaz Web Fácil de Usar:

Desarrollado con Gradio para una interacción sencilla.

RequisitosAsegúrate de tener Python 3.8 o superior instalado.


Configuración del Entorno:

1. Clave API de Google Gemini

Este chatbot utiliza la API de Google Gemini para generar respuestas.

Necesitarás obtener una clave API.

Obtén tu Clave API: Visita Google AI Studio y crea una nueva clave API.

2. Configuración Local

Si deseas ejecutar el bot en tu máquina local:

Clona el Repositorio (o descarga los archivos):

git clone <URL_DE_TU_REPOSITORIO>
cd <nombre_de_tu_repositorio>


(Si no usas Git, simplemente descarga app.py y requirements.txt en una carpeta).

Crea un Entorno Virtual (Recomendado):

python -m venv venv

En Windows:

# .\venv\Scripts\activate

En macOS/Linux:
# source venv/bin/activate

Instala las Dependencias:Crea un archivo llamado requirements.txt en la misma carpeta que app.py con el siguiente contenido:

gradio==4.36.1
pandas==2.2.2
PyPDF2==3.0.1
requests==2.32.3
openpyxl==3.1.2

Luego, instala las dependencias:pip

# install -r requirements.txt

Configura la Clave API como Variable de Entorno:

El bot espera encontrar tu clave API de Gemini en una variable de entorno llamada GEMINI_API_KEY.

En macOS/Linux (para la sesión actual de terminal):

export GEMINI_API_KEY="TU_CLAVE_API_DE_GEMINI_AQUÍ"


Para que persista entre sesiones, puedes añadir esta línea a tu archivo

# ~/.bashrc, ~/.zshrc o ~/.profile.

En Windows (para la sesión actual de CMD):

> set GEMINI_API_KEY="TU_CLAVE_API_DE_GEMINI_AQUÍ"

Para que persista, puedes añadirla a las variables de entorno del sistema (Panel de Control -> Sistema y Seguridad -> Sistema -> Configuración avanzada del sistema -> Variables de entorno).

Ejecuta la Aplicación:

# python app.py

Esto iniciará el servidor de Gradio y te proporcionará una URL (normalmente http://127.0.0.1:7860) donde puedes acceder al chatbot en tu navegador.


3. Despliegue en Hugging Face Spaces

Para desplegar el bot en Hugging Face Spaces:

Crea un Nuevo Space:Ve a Hugging Face Spaces.
Haz clic en "Create new Space".
Elige un nombre para tu Space.
Selecciona "Gradio" como el SDK.
Elige la licencia y si será público o privado.
Haz clic en "Create Space".

Configura la Clave API como Secreto del Repositorio:

Una vez creado tu Space, ve a la pestaña "Settings" (Configuración).
Desplázate hacia abajo hasta la sección "Repository secrets" (Secretos del repositorio).
Haz clic en "Add a new secret" (Añadir un nuevo secreto).
En el campo "Name", escribe GEMINI_API_KEY (¡es crucial que el nombre sea exactamente este!).
En el campo "Value", pega tu clave API de Google Gemini.Haz clic en "Add secret".

Sube los Archivos:

Ve a la pestaña "Files" (Archivos) de tu Space.
Haz clic en "Add file" -> "Upload file".Sube tu archivo app.py.
Repite el proceso para subir tu archivo requirements.txt (con el contenido listado en la sección "Instala las Dependencias" anterior).

Espera el Despliegue:

Hugging Face Spaces detectará automáticamente los archivos y comenzará a construir y desplegar tu aplicación.
Esto puede tardar unos minutos. Una vez completado, tu chatbot estará disponible en la URL de tu Space.

Uso del BotCargar Base de Conocimientos:

Sube un archivo CSV, XLSX o PDF utilizando el botón "Sube tu base de conocimientos".

Haz clic en "Cargar Base de Conocimientos".
El estado de la carga se mostrará en el cuadro de texto.
Seleccionar Personalidad:Elige la personalidad deseada para el bot en el menú desplegable "Personalidad del Bot".

Chatear con el Bot:

Escribe tu pregunta en el cuadro de texto "Tu Pregunta".

Haz clic en "Enviar Pregunta".
La respuesta del bot aparecerá en el cuadro de texto "Respuesta del ChatBot"

¡Disfruta usando tu chatbot configurable!

README.md

@@ -1,5 +1,5 @@
 ---
-title: Chatcot Personalizable
+title: ChatBot Personalizable
 emoji: 🐨
 colorFrom: purple
 colorTo: pink
@@ -10,4 +10,4 @@ pinned: false
 short_description: Bot en español con base de conocimientos
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference