{"id":28962412,"url":"https://github.com/retype15/cuba_matricle_university","last_synced_at":"2026-04-28T17:01:44.139Z","repository":{"id":298641077,"uuid":"991577884","full_name":"Retype15/cuba_matricle_university","owner":"Retype15","description":"Aplicación web interactiva para el análisis exhaustivo de los datos de matrícula en las universidades de Cuba, cubriendo el período académico desde 2015-2016 hasta 2024-2025. Desarrollada con Streamlit, la herramienta permite a los usuarios explorar tendencias nacionales, la distribución de estudiantes por ramas del saber","archived":false,"fork":false,"pushed_at":"2025-07-09T02:32:01.000Z","size":1450,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-09T22:31:31.874Z","etag":null,"topics":["cuba","data-science","storytelling","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Retype15.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-27T20:53:36.000Z","updated_at":"2025-07-09T02:32:05.000Z","dependencies_parsed_at":"2025-07-02T07:30:28.041Z","dependency_job_id":"f8457e9e-a89a-4d26-971c-34f20cdff135","html_url":"https://github.com/Retype15/cuba_matricle_university","commit_stats":null,"previous_names":["retype15/cuba_matricle_university"],"tags_count":0,"template":false,"template_full_name":"streamlit/gdp-dashboard-template","purl":"pkg:github/Retype15/cuba_matricle_university","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Retype15%2Fcuba_matricle_university","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Retype15%2Fcuba_matricle_university/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Retype15%2Fcuba_matricle_university/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Retype15%2Fcuba_matricle_university/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Retype15","download_url":"https://codeload.github.com/Retype15/cuba_matricle_university/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Retype15%2Fcuba_matricle_university/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32390067,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T14:34:11.604Z","status":"ssl_error","status_checked_at":"2026-04-28T14:32:37.009Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cuba","data-science","storytelling","streamlit"],"created_at":"2025-06-24T03:05:56.674Z","updated_at":"2026-04-28T17:01:44.127Z","avatar_url":"https://github.com/Retype15.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎓 Análisis Estratégico de la Matrícula Universitaria en Cuba (2015-2025)\n\n[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://cuba-matricle-university.streamlit.app/)\n\u003c!-- 🔗 Reemplaza 'https://cuba-matricle-university.streamlit.app/' con el enlace real a tu app desplegada en Streamlit Community Cloud --\u003e\n\n## 🌟 Descripción del Proyecto\n\nEste proyecto presenta una aplicación web interactiva para el análisis exhaustivo de los datos de matrícula en las universidades de Cuba, cubriendo el período académico desde 2015-2016 hasta 2024-2025. Desarrollada con Streamlit, la herramienta permite a los usuarios explorar tendencias nacionales, la distribución de estudiantes por ramas del saber y carreras específicas, análisis de equidad de género, la especialización de las universidades, y proyecciones futuras basadas en modelos de regresión lineal.\n\nEl objetivo principal es proporcionar *insights* visuales y basados en datos que sirvan de apoyo fundamental para la toma de decisiones estratégicas por parte de la Sede Central que gestiona las universidades cubanas. Adicionalmente, busca ofrecer información valiosa y accesible para investigadores, planificadores educativos, estudiantes y el público general interesado en el panorama de la educación superior en Cuba.\n\n## ✨ Características Clave\n\n*   **Visión Histórica Detallada:** Evolución de la matrícula a nivel nacional, por rama de ciencias y por carrera individual.\n*   **Proyecciones a Futuro:** Estimaciones a 2 años para la matrícula total, por ramas y para carreras seleccionadas interactivamente, utilizando regresión lineal sobre los últimos 6 años de datos.\n*   **Análisis de Género:** Visualización clara de la participación femenina en diferentes áreas del conocimiento y carreras específicas, destacando avances y desafíos.\n*   **Dinámica Institucional:** Exploración de la concentración y especialización de las universidades, y comparativas de matrícula para carreras estratégicas entre diferentes instituciones.\n*   **Identificación de Áreas de Atención:** Detección proactiva de carreras con matrícula reducida, posibles nuevas ofertas o ceses de programas.\n*   **Interfaz Intuitiva y Dinámica:** Navegación fluida por secciones temáticas, gráficos interactivos generados con Plotly y la capacidad para que el usuario seleccione carreras de interés para análisis específicos.\n*   **Narrativa Basada en Datos (Storytelling):** Presentación de los hallazgos estructurada y con interpretaciones para facilitar la comprensión del impacto de los datos.\n\n## 🛠️ Stack Tecnológico\n\n*   **Lenguaje Principal:** Python 3.13.1\n*   **Framework de la Aplicación Web:** Streamlit\n*   **Manipulación y Análisis de Datos:** Pandas\n*   **Visualizaciones Interactivas:** Plotly\n*   **Operaciones Numéricas:** NumPy\n*   **Modelado (Regresión Lineal):** Scikit-learn\n\n## 🚀 Despliegue y Ejecución Local\n\n### Acceder a la Aplicación Desplegada\n\nPuedes interactuar con la versión desplegada de esta aplicación directamente en Streamlit Community Cloud:\n[**Acceder a la App en Streamlit**](https://cuba-matricle-university.streamlit.app/)\n\n### Ejecutar en tu Máquina Local\n\nSi deseas ejecutar la aplicación en tu propio entorno para desarrollo o pruebas:\n\n1.  **Clona el Repositorio:**\n    ```bash\n    git clone https://github.com/Retype15/cuba_matricle_university.git\n    cd cuba_matricle_university\n    ```\n\n2.  **Crea y Activa un Entorno Virtual (Recomendado):**\n    ```bash\n    python -m venv venv\n    ```\n    *   Windows: `.\\venv\\Scripts\\activate`\n    *   macOS/Linux: `source venv/bin/activate`\n\n3.  **Instala las Dependencias:**\n    Con el entorno virtual activado, instala los paquetes necesarios:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n4.  **Prepara el Archivo de Datos:**\n    Asegúrate de que el archivo de datos `db.parquet` y `db_uni.parquet` se encuentre en la carpeta *data* del directorio del proyecto.\n\n5.  **Ejecuta la Aplicación:**\n    Utiliza el siguiente comando en tu terminal:\n    ```bash\n    streamlit run streamlit_app.py\n    ```\n    Streamlit iniciará un servidor local y la aplicación se abrirá en tu navegador (usualmente en `http://localhost:8501`).\n\n## 📊 Datos\nLa aplicación se basa en un conjunto de datos proporcionados por el **Ministerio de Educación Superior** que detalla la matrícula en universidades cubanas por rama de ciencias, carrera, entidad (universidad) y género, para los cursos académicos desde 2015-2016 hasta 2024-2025, obviando el curso 2018-2019 por causas aún desconocidas.\n\n## 🧑‍💻 Colaboradores del Proyecto\n\n*   Reynier Ramos\n*   Ernesto [Apellido Pendiente]\n\n## 📜 Licencia\n\nEste proyecto se distribuye bajo los términos de la **Licencia Apache 2.0**.\nPuedes encontrar el texto completo de la licencia en el archivo `LICENSE` de este repositorio o en:\n[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\n---\n\nEsperamos que esta herramienta analítica sea de gran utilidad. ¡Cualquier feedback es bienvenido!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fretype15%2Fcuba_matricle_university","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fretype15%2Fcuba_matricle_university","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fretype15%2Fcuba_matricle_university/lists"}