/kaax_analytics

Kaax Analytics es una plataforma abierta al público diseñada para democratizar el acceso a la información analítica y predictiva en el sector agrícola. Con el uso de fuentes confiables como SENACYT, nuestro objetivo es ofrecer análisis complejos y modelos de predicción accesibles a todos.

Primary LanguagePythonMIT LicenseMIT

Kaax Analytics - Agricultural Statistics for Guatemala

Kaax Analytics es una plataforma open source desarrollada en Streamlit que permite visualizar estadísticas clave sobre el sector agrícola de Guatemala. Su objetivo es ofrecer a investigadores, agricultores y organizaciones una herramienta fácil de usar para analizar datos de producción y rendimiento agrícola en el país.

Características

  • Visualización de Estadísticas de Producción Agrícola: Muestra datos detallados sobre diversos cultivos, incluyendo caña de azúcar y otros productos clave de la región.
  • Análisis de Hectáreas Cultivadas: Incluye visualizaciones que permiten ver el rendimiento por hectárea para diferentes tipos de cultivos.
  • Gráficos Interactivos y Tablas: Facilita la interpretación de tendencias de producción mediante gráficos y tablas dinámicas.
  • Datos Filtrables: Permite filtrar los datos por tipo de cultivo, año, región, y otros parámetros específicos.

Tecnologías Utilizadas

  • Python: Lenguaje principal utilizado para el desarrollo de la lógica de datos.
  • Streamlit: Framework de frontend que permite crear aplicaciones web interactivas en Python.
  • Firebase: Utilizado para almacenar datos y gestionar la autenticación de usuarios (opcional).

Requisitos Previos

Asegúrate de tener instaladas las siguientes dependencias:

  • Python 3.8 o superior
  • Streamlit
  • Firebase SDK para Python (opcional, si se requiere autenticación o almacenamiento)

Instalación

  1. Clona el repositorio:
git clone https://github.com/tu_usuario/kaax-analytics.git
cd kaax-analytics
  1. Instala las dependencias:
pip install -r requirements.txt

  1. Configura Firebase (opcional): Si deseas habilitar la autenticación y almacenamiento de datos en Firebase, configura el archivo firebase_config.json en el directorio raíz del proyecto.

  2. Ejeccuta la aplicación:

streamlit run app.py

Uso

  1. Abre tu navegador y ve a http://localhost:8501.
  2. Selecciona los cultivos y parámetros que deseas analizar.
  3. Explora los gráficos y tablas interactivos para obtener insights detallados sobre la producción agrícola de Guatemala.

Contribución

Las contribuciones son bienvenidas. Para contribuir, sigue estos pasos:

  1. Haz un fork del repositorio.

  2. Crea una nueva rama:

git checkout -b feature/nueva-funcionalidad
  1. Realiza tus cambios y confirma los commits:
git commit -m 'Agrega nueva funcionalidad'
  1. Sube tus cambios a tu fork:
git push origin feature/nueva-funcionalidad
  1. Crea un Pull Request en el repositorio original.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para obtener más detalles.

Contacto

Para preguntas o sugerencias, no dudes en contactarnos en erivas@ahau-x.com o a través de nuestras redes sociales.

¡Gracias por utilizar Kaax Analytics y contribuir al desarrollo de la agricultura en Guatemala!