Biochat

Biochat es un chatbot con el cual puedes resolver todas tus dudas respecto a la COP 16 realizada durante octubre de 2024 en la ciudad de Cali, Colombia. Además puedes consultarle sobre la biodiversidad de la ciudad de Cali. La aplicación también permite reconocer aves mediante su foto y traer datos curiosos.

Requisitos

Solo se requiere un API key para el servicio de Gemini.

Estructura del proyecto

• Carpeta backend: Servidor backend que realiza la clasificación de imagenes.
• Carpeta frontend: Interfaz gráfica de la aplicación que aloja el chatbot.

Servicios de inteligencia artificial

• Gemini 2.5 flash.
• Modelo ozzyonfire/bird-species-classifier de Hugging face.

Frontend

Librerías

• React: 18.3.1
• Chakra UI: 2.8.2
• Google generative AI: 0.19.0

Ejecución

1. Abre una terminal dentro de la carpeta frontend e instala las dependencias del proyecto

npm install

2. Crea un archivo .env en la carpeta raíz del proyecto usando como plantilla el archivo .env.example.

Para ver la lista de modelos disponibles, visita la documentación de Gemini API. 4. Ejecuta el servidor de pruebas

npm run dev

La aplicación es accesible a través del localhost:5173.

Backend

Librerías

• Flask: 3.0.3
• Transformers: 4.44.2
• Pillow: 10.4.0
• Torch: 2.4.1
• Gunicorn: 23.0.0

Ejecución

1. Cree un entorno virtual de Python:

virtualenv -m <nombre-entorno>

Acceda al entorno con el siguiente comando (según su sistema operativo):

.\<nombre-entorno>\Scripts\activate        # En el caso de Windows
source .\<nombre-entorno>\Scripts          # En el caso de MacOS y Linux

2. Instale las dependencias del proyecto

pip install -r requirements.txt

3. Ejecuta el servidor

python run.py

El servidor se estará ejecutando en el localhost puerto 5000. Para producción utilice el comando:

gunicorn -w <num-workers> "run:app"

¿Cómo hacer peticiones?

Endpoint /clasificar

• Método: POST.
• Body:

FormData({
    "file": <Imagen-en-base-64>
})

Nota: Solo se soportan archivos en formato JPG, JPEG y PNG.