{"id":15024725,"url":"https://github.com/dylanhurtado/gnomos-simulation-ia","last_synced_at":"2026-01-06T12:07:07.061Z","repository":{"id":256757047,"uuid":"852775509","full_name":"DyLaNHurtado/gnomos-simulation-ia","owner":"DyLaNHurtado","description":"Simulador de gnomos cocineros (Python/Vue.js)","archived":false,"fork":false,"pushed_at":"2024-09-12T19:01:39.000Z","size":25468,"stargazers_count":1,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-21T00:05:25.506Z","etag":null,"topics":["api","contributions-welcome","cooking-simulation","django","fantasy","funny","funny-game","gnome","ia","machine-learning","open-source","python","python3","rest","simulation","vuejs"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DyLaNHurtado.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-09-05T12:05:17.000Z","updated_at":"2024-09-12T20:58:54.000Z","dependencies_parsed_at":"2024-09-12T23:39:10.417Z","dependency_job_id":null,"html_url":"https://github.com/DyLaNHurtado/gnomos-simulation-ia","commit_stats":null,"previous_names":["dylanhurtado/gnomos-simulation-ia"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DyLaNHurtado%2Fgnomos-simulation-ia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DyLaNHurtado%2Fgnomos-simulation-ia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DyLaNHurtado%2Fgnomos-simulation-ia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DyLaNHurtado%2Fgnomos-simulation-ia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DyLaNHurtado","download_url":"https://codeload.github.com/DyLaNHurtado/gnomos-simulation-ia/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240014282,"owners_count":19734236,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["api","contributions-welcome","cooking-simulation","django","fantasy","funny","funny-game","gnome","ia","machine-learning","open-source","python","python3","rest","simulation","vuejs"],"created_at":"2024-09-24T20:00:48.046Z","updated_at":"2026-01-06T12:07:06.969Z","avatar_url":"https://github.com/DyLaNHurtado.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧑‍🍳 Simulación de Gnomos Cocineros 🧙‍♂️\n\nBienvenidos a **Simulación de Gnomos Cocineros**, una simulación matemática que combina probabilidad y gestión en un entorno fantasioso. Este proyecto busca simular las habilidades únicas de cinco gnomos cocineros que deben cumplir una misión: preparar un banquete para la gran fiesta del pueblo. Enfréntate a desafíos como la gestión del tiempo, la obtención de ingredientes raros y el control de eventos aleatorios que pueden alterar el resultado final.\n\n## 🎯 Objetivo del Proyecto\n\nEl objetivo es crear una **simulación automática** que modele el comportamiento de cinco gnomos cocineros: el panadero, el chef de sopas, el pastelero, el carnicero y el aprendiz. Cada gnomo tiene habilidades específicas y sus acciones estarán regidas por **algoritmos probabilísticos avanzados** y **eventos aleatorios**. Al finalizar la simulación, se mostrará un **reporte detallado** con los resultados del banquete y el rendimiento de cada gnomo.\n\n## 🚀 Estado Actual\n\nEl proyecto está en una fase inicial y aún no se ha implementado ninguna funcionalidad. La planificación está avanzada y contamos con una visión clara de la arquitectura y los objetivos de cada parte del sistema.\n\n## 🛠️ Funcionalidades Clave\n\n### 🔧 Funcionalidades Principales\n- **Simulación automática**: Una vez iniciada, la simulación se ejecuta automáticamente sin intervención del usuario.\n- **Cinco gnomos con roles específicos**: Panadero, chef de sopas, pastelero, carnicero y aprendiz, cada uno con habilidades y comportamientos únicos.\n- **Probabilidad y gestión de tiempo**: La lógica de la simulación se basa en probabilidades y eventos aleatorios, donde cada tarea tiene un porcentaje de éxito basado en las habilidades del gnomo.\n- **Eventos externos**: Se introducen eventos aleatorios como la obtención de ingredientes raros o imprevistos que dificultan la cocción.\n- **IA adaptativa**: Cada gnomo sigue patrones de comportamiento inspirados en IA clásica (como los fantasmas de Pacman), adaptándose a los eventos del juego.\n- **Reporte final**: Al finalizar la simulación, se genera un reporte con el desempeño de cada gnomo y el resultado del banquete.\n\n### 🌐 Plataforma y Tecnología\n- **Frontend**: Construido con **Vue.js**, ofrecerá una interfaz simple para iniciar simulaciones y visualizar los resultados. El tablero de visualización incluirá sprites de los gnomos estilo **pixel art**.\n- **Backend**: El motor de simulación será manejado por **Python con Django**, lo que permitirá cálculos complejos y algoritmos probabilísticos.\n- **Tiempo Real**: El frontend permitirá una visualización en tiempo real del progreso de la simulación y los eventos que ocurren.\n- **Base de datos**: **PostgreSQL** será la base de datos encargada de almacenar los resultados de cada simulación, así como el desempeño de los gnomos.\n\n## 🔮 Futuras Funcionalidades\n\n### 🕹️ Modos y Opciones\n- **Simulaciones avanzadas**: Se planea añadir más eventos externos y complejidades a la lógica de los gnomos, para hacer el juego más impredecible.\n- **Editor de simulaciones**: En el futuro, se permitirá a los usuarios crear sus propios gnomos con habilidades personalizadas y ajustar las probabilidades de éxito.\n\n### 🎨 Visualización y Animaciones\n- **Tablero animado**: Implementaremos un tablero en el frontend que mostrará el progreso de la simulación, incluyendo animaciones de los gnomos cocinando y buscando ingredientes.\n- **Sprites estilo pixel art**: Se añadirán gráficos estilo retro para darle un toque divertido y nostálgico a la visualización.\n\n### 🧠 Algoritmos de Probabilidad e IA\n- **Comportamiento avanzado de gnomos**: Cada gnomo tendrá un algoritmo único que regirá su comportamiento en base a su rol y habilidades, inspirados en IA como los patrones de movimiento de los fantasmas de Pacman.\n- **Eventos externos complejos**: Introduciremos un sistema de eventos aleatorios que incluirá factores externos como el clima, disponibilidad de ingredientes o invitados adicionales al banquete.\n  \n### ⚙️ Rendimiento y Escalabilidad\n- **Escalabilidad en la nube**: Se planea optimizar la simulación para permitir múltiples ejecuciones simultáneas en entornos de servidores como AWS o Heroku.\n- **Procesamiento paralelo**: En simulaciones más complejas, el motor podrá hacer uso de procesamiento paralelo para reducir tiempos de cálculo.\n\n## 🛠️ Arquitectura del Sistema\n\nLa aplicación sigue una arquitectura de tres capas: **frontend**, **backend** y **base de datos**, con Django como el framework del backend.\n\n```plantuml\n@startuml\nskinparam style strictuml\nactor User\nnode \"Cliente\" {\n  [Frontend (Vue.js)]\n}\nnode \"Servidor\" {\n  [API Backend (Django)] --\u003e [Motor de Simulación]\n  [Motor de Simulación] --\u003e [Base de Datos (PostgreSQL)]\n}\nUser --\u003e [Frontend (Vue.js)]\n[Frontend (Vue.js)] --\u003e [API Backend (Django)]\n@enduml\n```\n\n### Descripción de Componentes\n\n#### Frontend (Vue.js)\n- **Funcionalidad**: Proveer una interfaz simple para iniciar la simulación y ver el progreso y resultados.\n- **Visualización**: Tablero con sprites de gnomos en **pixel art**, mostrando en tiempo real las tareas que cada gnomo está realizando.\n\n#### Backend (Django)\n- **API**: Exponer endpoints REST para iniciar la simulación, consultar resultados y obtener reportes.\n- **Motor de Simulación**: Ejecución de la lógica probabilística para la simulación.\n- **Persistencia**: Guardar los resultados en la base de datos y generar reportes.\n\n#### Motor de Simulación\n- **Lógica de simulación**: Implementada en Python, basada en modelos probabilísticos y eventos aleatorios.\n- **IA de Gnomos**: Cada gnomo sigue un algoritmo de comportamiento personalizado.\n\n#### Base de Datos (PostgreSQL)\n- **Estructura**:\n  - **Tabla Gnomos**: Información sobre cada gnomo (nombre, rol, habilidades).\n  - **Tabla Simulaciones**: Registro de cada simulación.\n  - **Tabla Resultados**: Resultados individuales de cada gnomo en cada simulación.\n\n## 🎯 ¿Cómo Contribuir?\n\n1. **Clona el repositorio** y crea una rama para tu contribución.\n2. Revisa las **issues** abiertas o sugiere mejoras.\n3. Implementa nuevas funcionalidades o resuelve bugs.\n4. Envía un **pull request** para revisión.\n\n## 🌟 Roadmap del Proyecto\n\n1. **Implementar la lógica básica de simulación**.\n2. **Desarrollar el frontend con visualización en tiempo real**.\n3. **Añadir eventos aleatorios y algoritmos complejos de IA**.\n4. **Optimización para múltiples simulaciones simultáneas en la nube**.\n5. **Lanzamiento de una versión beta para pruebas comunitarias**.\n\n---\n\n¡Gracias por interesarte en este proyecto! 🚀 Si te gusta la simulación y la gestión de probabilidades, ¡este es el proyecto para ti! 😎\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylanhurtado%2Fgnomos-simulation-ia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdylanhurtado%2Fgnomos-simulation-ia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylanhurtado%2Fgnomos-simulation-ia/lists"}