Update README.md

README.md

@@ -1,14 +1,71 @@
 
-# Chatbot LLM con API de Hugging Face
+# Proyecto 1: Chatbot LLM con API de Hugging Face
 
-## Descripción
+## 📋 Descripción
 Este proyecto es un chatbot interactivo que utiliza un modelo de lenguaje de Hugging Face para responder preguntas en tiempo real. La aplicación está construida con Gradio, lo que permite al usuario interactuar fácilmente con el modelo a través de una interfaz gráfica.
 
-## Modelo Utilizado
+---
+
+## 📦 Requisitos
+Antes de ejecutar este proyecto, asegúrate de tener lo siguiente instalado en tu equipo:
+- **Python 3.8 o superior**
+- **Gradio**
+- **huggingface_hub**
+
+Instala las dependencias ejecutando:
+```bash
+pip install gradio huggingface_hub
+```
+
+---
+
+## 🔐 Configuración del Token de Hugging Face
+El proyecto requiere un **token de acceso** de Hugging Face para conectarse a la API del modelo.
+
+### Cómo Obtener un Token
+1. Inicia sesión en tu cuenta de Hugging Face:  
+   👉 [https://huggingface.co/settings/tokens](https://huggingface.co/settings/tokens)
+2. Crea un nuevo token con los siguientes permisos habilitados:
+   - **`Read`** (lectura)
+3. Copia el token generado.
+
+### Configura el Token como Variable de Entorno
+Para mantener tu token seguro, configúralo como una variable de entorno en tu sistema:
+
+- **Windows (PowerShell):**
+   ```powershell
+   $env:HF_API_TOKEN="TU_TOKEN"
+   ```
+
+- **Linux/macOS:**
+   ```bash
+   export HF_API_TOKEN="TU_TOKEN"
+   ```
+
+---
+
+## 🚀 Cómo Ejecutar el Archivo
+1. Guarda el código en un archivo llamado **`app.py`**.
+2. Abre la terminal en la carpeta donde guardaste el archivo.
+3. Ejecuta el archivo con el siguiente comando:
+
+```bash
+python app.py
+```
+
+4. Abre el navegador y visita la URL proporcionada (por defecto: `http://127.0.0.1:7860`).
+
+---
+
+## 📚 Modelo Usado
 - **Modelo:** `microsoft/Phi-3-mini-4k-instruct`
 - **Fuente:** Hugging Face
 
-## Parámetros en la Petición
+El modelo está diseñado para responder preguntas en lenguaje natural.
+
+---
+
+## 📤 Parámetros en la Petición
 La aplicación realiza peticiones a la API de Hugging Face utilizando los siguientes parámetros:
 - **`messages`**: Lista de mensajes en formato JSON. Ejemplo:
   ```json
@@ -18,48 +75,31 @@ La aplicación realiza peticiones a la API de Hugging Face utilizando los siguie
   ```
 - **`max_tokens`**: Número máximo de tokens en la respuesta (500).
 
-## Ejemplo de Uso
-1. Ejecuta la aplicación en tu entorno local:
-   ```bash
-   python app.py
+---
+
+## ✨ Ejemplo de Uso
+1. Ingresa una pregunta en el cuadro de texto, por ejemplo:
+   ```text
+   ¿Cuál es la capital de Francia?
+   ```
+2. Presiona el botón **"Enviar"**.
+3. La respuesta generada será:
+   ```text
+   La capital de Francia es París.
    ```
-2. Abre la interfaz gráfica en tu navegador (por defecto: `http://127.0.0.1:7860`).
-3. Ingresa tu pregunta en el cuadro de texto y selecciona "Enviar".
 
-### Ejemplo de Entrada:
-```text
-¿Cuál es la capital de Francia?
-```
+---
 
-### Ejemplo de Salida:
-```text
-La capital de Francia es París.
+## ⚙️ Instalación Opcional (Entorno Virtual)
+Para mantener las dependencias aisladas, puedes crear un entorno virtual:
+```bash
+python -m venv venv
+source venv/bin/activate  # En Linux/macOS
+.env\Scriptsctivate  # En Windows
 ```
 
-## Requisitos
-- **Python 3.8 o superior**
-- **Gradio 5.9.1**
-- **huggingface_hub**
+---
 
-## Instalación
-1. Clona el repositorio o copia los archivos del proyecto.
-   ```bash
-   git clone https://huggingface.co/spaces/tu_usuario/tu_space
-   cd tu_space
-   ```
-2. Crea un entorno virtual (opcional pero recomendado):
-   ```bash
-   python3 -m venv venv
-   source venv/bin/activate  # En Windows: venv\Scripts\activate
-   ```
-3. Instala las dependencias:
-   ```bash
-   pip install -r requirements.txt
-   ```
-4. Configura tu token de Hugging Face como variable de entorno:
-   ```bash
-   export HF_API_TOKEN=tu_token
-   ```
-
-## Licencia
+## 📄 Licencia
 Este proyecto está bajo la licencia MIT.
+