{"id":27974614,"url":"https://github.com/bladealex9848/leonai","last_synced_at":"2026-05-09T06:35:21.043Z","repository":{"id":287272800,"uuid":"876217771","full_name":"bladealex9848/LeonAI","owner":"bladealex9848","description":"Guillo es un agente de IA que te brinda información sobre la Institución Educativa Bosques de León.","archived":false,"fork":false,"pushed_at":"2025-04-10T20:37:22.000Z","size":446,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-22T05:03:43.816Z","etag":null,"topics":["python","rag","streamlit"],"latest_commit_sha":null,"homepage":"https://leonai.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bladealex9848.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-10-21T15:38:35.000Z","updated_at":"2025-04-10T20:37:25.000Z","dependencies_parsed_at":"2025-04-10T21:43:44.573Z","dependency_job_id":null,"html_url":"https://github.com/bladealex9848/LeonAI","commit_stats":null,"previous_names":["bladealex9848/leonai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bladealex9848/LeonAI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bladealex9848%2FLeonAI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bladealex9848%2FLeonAI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bladealex9848%2FLeonAI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bladealex9848%2FLeonAI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bladealex9848","download_url":"https://codeload.github.com/bladealex9848/LeonAI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bladealex9848%2FLeonAI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32809849,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["python","rag","streamlit"],"created_at":"2025-05-08T00:19:01.613Z","updated_at":"2026-05-09T06:35:21.020Z","avatar_url":"https://github.com/bladealex9848.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Guillo 🦁\n\n![Logo de LeonAI](https://github.com/bladealex9848/LeonAI/blob/main/assets/logo.jpg)\n\n[![Version](https://img.shields.io/badge/versión-1.0.0-darkgreen.svg)](https://github.com/bladealex9848/LeonAI)\n[![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/)\n[![Streamlit](https://img.shields.io/badge/Streamlit-1.30.0-ff4b4b.svg)](https://streamlit.io/)\n[![OpenAI](https://img.shields.io/badge/OpenAI_API-v2-00C244.svg)](https://platform.openai.com/)\n[![Licencia](https://img.shields.io/badge/Licencia-MIT-yellow.svg)](LICENSE)\n[![Visitantes](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fleonai.streamlit.app\u0026label=Visitantes\u0026labelColor=%235d5d5d\u0026countColor=%231e7ebf\u0026style=flat)](https://leonai.streamlit.app)\n\n## 🦁 Descripción\n\nGuillo es un asistente virtual desarrollado con Streamlit y la API de OpenAI, especializado en brindar información sobre la Institución Educativa Bosques de León. Este asistente está diseñado para ayudar a estudiantes, padres, profesores y personal administrativo a obtener respuestas precisas sobre la filosofía institucional, procesos académicos, normas de convivencia y eventos escolares.\n\nEl asistente tiene acceso a documentación oficial de la institución, permitiéndole proporcionar información actualizada y confiable sobre todos los aspectos relacionados con la Institución Educativa Bosques de León, facilitando así la comunicación y el acceso a la información para toda la comunidad educativa.\n\n## 🔍 Funcionalidades Principales\n\n### 1. Información Institucional\n- **Filosofía Institucional**: Detalles sobre la misión, visión y valores del colegio\n- **Proyecto Educativo**: Información sobre el enfoque pedagógico y formativo\n- **Historia y Trayectoria**: Datos sobre los orígenes y desarrollo de la institución\n- **Políticas Institucionales**: Explicación de las directrices y políticas educativas\n\n### 2. Procesos Académicos\n- **Admisión y Matrícula**: Requisitos y procedimientos para nuevos estudiantes\n- **Evaluación y Promoción**: Sistema de calificación y criterios de promoción\n- **Calendario Académico**: Fechas importantes del año escolar\n- **Niveles Educativos**: Información sobre preescolar, primaria y bachillerato\n\n### 3. Convivencia Escolar\n- **Manual de Convivencia**: Explicación de las normas y reglamentos\n- **Derechos y Deberes**: Información sobre responsabilidades y derechos de los estudiantes\n- **Uniformes**: Especificaciones sobre el uniforme escolar y su uso\n- **Conducto Regular**: Procedimientos para resolución de conflictos\n\n### 4. Eventos y Actividades\n- **Ceremonias Institucionales**: Información sobre graduaciones y primeras comuniones\n- **Actividades Extracurriculares**: Detalles sobre clubes, deportes y actividades adicionales\n- **Salidas Pedagógicas**: Procesos y requisitos para excursiones escolares\n- **Eventos Especiales**: Fechas y detalles de celebraciones institucionales\n\n### 5. Recursos Tecnológicos\n- **Plataforma Cisco Webex**: Guía para acceso y uso de la plataforma virtual\n- **Recursos Digitales**: Información sobre herramientas educativas disponibles\n- **Comunicación Digital**: Canales oficiales y protocolos de comunicación\n- **Soporte Técnico**: Ayuda básica para problemas comunes con plataformas institucionales\n\n## 🚀 Instalación\n\n### Requisitos Previos\n- Python 3.8 o superior\n- Pip (administrador de paquetes de Python)\n- Cuenta en OpenAI con acceso a la API\n- Asistente Guillo configurado en OpenAI\n\n### Pasos de Instalación\n\n1. **Clonar el repositorio**\n   ```bash\n   git clone https://github.com/bladealex9848/LeonAI.git\n   cd LeonAI\n   ```\n\n2. **Crear un entorno virtual (recomendado)**\n   ```bash\n   python -m venv venv\n   \n   # En Windows\n   venv\\Scripts\\activate\n   \n   # En macOS/Linux\n   source venv/bin/activate\n   ```\n\n3. **Instalar las dependencias**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Configurar credenciales**\n\n   **Opción A: Usando variables de entorno**\n   ```bash\n   # En Windows\n   set OPENAI_API_KEY=tu-api-key-aqui\n   set ASSISTANT_ID=tu-assistant-id-aqui\n   \n   # En macOS/Linux\n   export OPENAI_API_KEY=tu-api-key-aqui\n   export ASSISTANT_ID=tu-assistant-id-aqui\n   ```\n\n   **Opción B: Usando archivo secrets.toml**\n   \n   Crea un archivo `.streamlit/secrets.toml` con el siguiente contenido:\n   ```toml\n   OPENAI_API_KEY = \"tu-api-key-aqui\"\n   ASSISTANT_ID = \"tu-assistant-id-aqui\"\n   ```\n\n## ⚙️ Uso\n\n### Iniciar la Aplicación\n\n```bash\nstreamlit run app.py\n```\n\nEsto lanzará la aplicación y abrirá automáticamente una ventana del navegador en `http://localhost:8501`.\n\n### Funcionalidades del Asistente\n\n1. **Consultas sobre la Institución**\n   - Pregunta sobre la filosofía, misión y visión institucional\n   - Ejemplo: \"¿Cuál es la misión de la Institución Educativa Bosques de León?\"\n\n2. **Información sobre Procesos Académicos**\n   - Consulta sobre admisiones, evaluaciones, promociones\n   - Ejemplo: \"¿Cómo es el proceso de admisión para primaria?\"\n\n3. **Consultas sobre Convivencia**\n   - Obtén información sobre normas, derechos y deberes\n   - Ejemplo: \"¿Cuáles son las normas sobre el uso del uniforme escolar?\"\n\n4. **Eventos Institucionales**\n   - Pregunta sobre celebraciones, ceremonias y actividades\n   - Ejemplo: \"¿Cuándo se realiza la ceremonia de graduación?\"\n\n5. **Ayuda con Plataformas**\n   - Obtén guía sobre el uso de Cisco Webex\n   - Ejemplo: \"¿Cómo puedo acceder a la plataforma virtual para clases?\"\n\n## ⚠️ Limitaciones\n\n- Guillo proporciona información general basada en la documentación disponible de la institución\n- Para trámites oficiales o información específica, se recomienda contactar directamente a la institución\n- El asistente no realiza procesos de inscripción, matrícula o pagos\n- La información proporcionada puede no estar completamente actualizada si ha habido cambios recientes\n\n## 📊 Escenarios de Uso\n\n### 1. Estudiantes\n- Consulta de normas y procedimientos académicos\n- Información sobre actividades extracurriculares\n- Aclaración de dudas sobre derechos y deberes\n\n### 2. Padres de Familia\n- Orientación sobre procesos de admisión y matrícula\n- Información sobre costos educativos y requisitos\n- Consultas sobre el calendario escolar y eventos\n\n### 3. Personal Docente y Administrativo\n- Acceso rápido a información institucional\n- Referencia sobre procesos y procedimientos\n- Apoyo para atención a consultas frecuentes\n\n## 👥 Contribuciones\n\nLas contribuciones son bienvenidas. Para contribuir al desarrollo de Guillo:\n\n1. Realiza un fork del repositorio\n2. Crea una nueva rama (`git checkout -b feature/nueva-funcionalidad`)\n3. Implementa tus cambios\n4. Envía un pull request\n\n## 📝 Licencia\n\nEste proyecto está bajo la licencia MIT. Consulta el archivo [LICENSE](LICENSE) para más detalles.\n\n## 🙏 Agradecimientos\n\n- **OpenAI** por proporcionar la tecnología que impulsa el asistente\n- **Streamlit** por facilitar el desarrollo de interfaces intuitivas\n- **Institución Educativa Bosques de León** por la información y documentación proporcionada\n\n## 👤 Autor\n\nCreado con ❤️ por [Alexander Oviedo Fadul](https://github.com/bladealex9848)\n\n[GitHub](https://github.com/bladealex9848) | [Website](https://alexanderoviedofadul.dev/) | [LinkedIn](https://www.linkedin.com/in/alexander-oviedo-fadul/) | [Instagram](https://www.instagram.com/alexander.oviedo.fadul) | [Twitter](https://twitter.com/alexanderofadul) | [Facebook](https://www.facebook.com/alexanderof/) | [WhatsApp](https://api.whatsapp.com/send?phone=573015930519\u0026text=Hola%20!Quiero%20conversar%20contigo!%20)\n\n---\n\n## 💼 Mensaje Final\n\nGuillo busca facilitar el acceso a la información sobre la Institución Educativa Bosques de León, promoviendo una comunicación más eficiente entre la institución y su comunidad educativa. Este asistente es una herramienta de apoyo que complementa los canales oficiales de comunicación de la institución.\n\n*\"La educación es el arma más poderosa que puedes usar para cambiar el mundo. En la Institución Educativa Bosques de León trabajamos cada día para formar ciudadanos íntegros, competentes y comprometidos con su entorno.\"*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbladealex9848%2Fleonai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbladealex9848%2Fleonai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbladealex9848%2Fleonai/lists"}