Create README.md
Browse files
README.md
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
|
| 2 |
+
# Chatbot Multi-Modelo LLM con API de Hugging Face
|
| 3 |
+
|
| 4 |
+
## Descripci贸n
|
| 5 |
+
Esta aplicaci贸n es un chatbot interactivo que utiliza un modelo de lenguaje de Hugging Face para responder preguntas en tiempo real. La interfaz gr谩fica est谩 construida con Gradio, y permite al usuario seleccionar diferentes acciones, como la generaci贸n de respuestas basadas en texto o la generaci贸n de im谩genes a partir de descripciones.
|
| 6 |
+
|
| 7 |
+
## Modelo Usado
|
| 8 |
+
El modelo utilizado en esta aplicaci贸n es:
|
| 9 |
+
- **Modelo:** `microsoft/Phi-3-mini-4k-instruct`
|
| 10 |
+
- **Fuente:** Hugging Face
|
| 11 |
+
|
| 12 |
+
## Par谩metros en la Petici贸n
|
| 13 |
+
La aplicaci贸n realiza una petici贸n a la API de Hugging Face utilizando los siguientes par谩metros:
|
| 14 |
+
- **`messages`**: Lista de mensajes en formato JSON. Ejemplo:
|
| 15 |
+
```json
|
| 16 |
+
[
|
| 17 |
+
{"role": "user", "content": "驴Cu谩l es la capital de Francia?"}
|
| 18 |
+
]
|
| 19 |
+
```
|
| 20 |
+
- **`max_tokens`**: N煤mero m谩ximo de tokens en la respuesta (500).
|
| 21 |
+
|
| 22 |
+
## Ejemplo de Uso
|
| 23 |
+
1. Ejecuta la aplicaci贸n en tu entorno local:
|
| 24 |
+
```bash
|
| 25 |
+
python app.py
|
| 26 |
+
```
|
| 27 |
+
2. Abre la interfaz gr谩fica en tu navegador (por defecto: `http://127.0.0.1:7860`).
|
| 28 |
+
3. Ingresa tu pregunta en el cuadro de texto y selecciona "Enviar".
|
| 29 |
+
|
| 30 |
+
### Ejemplo de Entrada:
|
| 31 |
+
```text
|
| 32 |
+
驴Cu谩l es la capital de Francia?
|
| 33 |
+
```
|
| 34 |
+
|
| 35 |
+
### Ejemplo de Salida:
|
| 36 |
+
```text
|
| 37 |
+
La capital de Francia es Par铆s.
|
| 38 |
+
```
|
| 39 |
+
|
| 40 |
+
## Requisitos
|
| 41 |
+
- **Python 3.8 o superior**
|
| 42 |
+
- **Gradio 5.9.1**
|
| 43 |
+
- **huggingface_hub**
|
| 44 |
+
|
| 45 |
+
## Instalaci贸n
|
| 46 |
+
1. Clona el repositorio o copia los archivos del proyecto.
|
| 47 |
+
```bash
|
| 48 |
+
git clone https://huggingface.co/spaces/tu_usuario/tu_space
|
| 49 |
+
cd tu_space
|
| 50 |
+
```
|
| 51 |
+
2. Crea un entorno virtual (opcional pero recomendado):
|
| 52 |
+
```bash
|
| 53 |
+
python3 -m venv venv
|
| 54 |
+
source venv/bin/activate # En Windows: venv\Scripts\activate
|
| 55 |
+
```
|
| 56 |
+
3. Instala las dependencias:
|
| 57 |
+
```bash
|
| 58 |
+
pip install -r requirements.txt
|
| 59 |
+
```
|
| 60 |
+
4. Configura tu token de Hugging Face como variable de entorno:
|
| 61 |
+
```bash
|
| 62 |
+
export HF_API_TOKEN=tu_token
|
| 63 |
+
```
|
| 64 |
+
|
| 65 |
+
## Licencia
|
| 66 |
+
Este proyecto est谩 bajo la licencia MIT.
|