Projects

Resumen del Proyecto Sandbox práctico para explorar flujos agénticos en FastAPI. El repositorio combina endpoints de carga en streaming con un agente LangGraph que usa herramientas externas, todo organizado con una arquitectura limpia para aprender y evolucionar. Contexto de Negocio Diseñado para experimentar mejores prácticas de programación agéntica sin las restricciones de un entorno productivo. Muestra cómo empaquetar patrones FastAPI + LangChain/LangGraph para extenderlos en aplicaciones reales. Enfatiza tanto el razonamiento del agente como la ergonomía de APIs backend. Capacidades Clave Cargas en streaming para PDF y binarios, además de ejemplos de archivos pequeños. Endpoint de agente LangGraph que invoca una herramienta de búsqueda Tavily con modelo Gemini. Checkpointing en memoria mediante SQLite para preservar el estado del agente. Gestión de configuración con Pydantic Settings. Arquitectura limpia con carpetas de adapters, domain y entrypoints. Flujo Docker con auto-recarga para iteraciones rápidas. Highlights de Arquitectura Se divide en dos apps FastAPI: be1/ para cargas en streaming y langgraph-demo/ para flujos agénticos. Docker Compose inicia la app LangGraph y expone la documentación interactiva automáticamente. Incluye notas y scaffolding para pruebas, persistencia y autenticación futuras. Mi Rol Ensamblé el demo, conecté los endpoints de streaming y el flujo LangGraph con herramientas, y documenté la estructura y el flujo Docker local. ...

Panorama del Proyecto Ejecuta experimentos de IA conversacional directamente en tu portátil. Este prototipo combina un pipeline de Hugging Face con salvaguardas sensibles a la GPU para iterar sin depender de servicios alojados. Contexto de Negocio Pensado para laboratorios y equipos sensibles al cumplimiento que necesitan validar chatbots sin enviar datos a la nube de terceros. Ofrece un punto de partida reproducible para incorporar colaboradores que trabajan en Linux, macOS y Windows. Capacidades Clave Inferencia local con BlenderBot impulsada por el checkpoint facebook/blenderbot-400M-distill mediante el pipeline text-to-text de transformers. Paridad notebook/script gracias al par sincronizado con Jupytext (basic_chat.ipynb ⇄ basic_chat.py), evitando desalineaciones entre IDE y navegador. Inicio amigable con GPU que configura PYTORCH_CUDA_ALLOC_CONF y limpia cachés CUDA para ajustar modelos en tarjetas de 2 GB, manteniendo la opción de ejecutar en CPU. Diagnósticos de entorno a través de gpu_ts.py y pt-cuda-ts, confirmando la disponibilidad de PyTorch/CUDA antes de reservar grandes tensores. Reproducibilidad con conda-lock mediante environment.yml, archivos bloque multi-plataforma y tareas de Makefile (make expenv, make updenv) que mantienen las dependencias alineadas. Notas de Implementación Incluye pasos concisos para instalar la versión adecuada de PyTorch, transformers, accelerate y sentencepiece. Promueve la gestión cuidadosa de VRAM mostrando cómo ajustar precisión o mapas de dispositivo dentro del pipeline. Licencia MIT y estructura pensada para intercambiar checkpoints más grandes o envolver la demo con interfaces tipo Gradio o Streamlit. Mi Rol Empaqueté el flujo del notebook, escribí los chequeos de salud de GPU y automaticé el bloqueo de dependencias para que el prototipado de LLM locales sea confiable para el equipo. ...

Panorama del Proyecto Los líderes comerciales necesitaban un sistema confiable para seguir incentivos en tarjetas, préstamos y campañas de cross-selling. Este backend organiza la gestión de metas, políticas de puntos y reportes listos para auditorías. Contexto de Negocio Sustituye hojas de cálculo que escondían el desempeño real y la elegibilidad de bonos. Ofrece a los gerentes tableros transparentes para acompañar a los equipos y sustentar pagos de incentivos. Sienta las bases de experiencias bancarias omnicanal al exponer APIs REST limpias. Capacidades Clave Autenticación con JWT protegida por Spring Security para cada endpoint. Flujos según rol que atienden a gerentes, asesores, analistas financieros y responsables de reportes. Motor de metas y puntos que vincula productos con niveles de recompensa, actualiza progreso y evita doble conteo. API integral que cubre gerentes, asesores, productos financieros, clientes, ventas e informes KPI. Arquitectura lista para tiempo real con soporte WebSocket para renovar rankings al instante. Notas de Implementación Spring Boot 3.1 con JPA administra la persistencia sobre MySQL, apoyado por H2 para pruebas locales. Documentación OpenAPI/Swagger autogenerada con SpringDoc para acelerar la adopción interna. Capas modulares (controladores, servicios, repositorios) que facilitan pruebas y extensiones futuras. Empaquetado con Maven para despliegues controlados por la infraestructura del banco. Mi Rol Rediseñé el proceso de recompensas heredado, modelé el dominio, implementé las capas de seguridad y datos, y configuré la base de observabilidad para la puesta en producción. ...

Panorama del Proyecto Los recolectores de datos de alto volumen suelen ser bloqueados cuando los nodos de salida Tor aparecen en listas negras. Este toolkit automatiza el cambio de circuitos para mantener el rendimiento sin sacrificar anonimato. Contexto de Negocio Ideal para equipos de investigación y cumplimiento que dependen de Tor para obtener información en redes restringidas. Evita que los procesos se detengan al detectar circuitos bloqueados o lentos y rotar antes de que fallen las solicitudes. Capacidades Clave Orquestación multicircuito que levanta conexiones Tor concurrentes para peticiones en paralelo. Monitoreo de salud de circuitos para identificar endpoints vetados y renovar al instante. Guía para miniaturas que destaca el uso de Tor en tableros o portafolios visuales. Diseñado como biblioteca personal para integrarse en pipelines mayores de scraping. Notas de Implementación Utilidades en Python con puntos de extensión para manejadores de colas o proxys personalizados. Separa claramente las señales de control de Tor de la lógica de negocio, simplificando las auditorías. Licencia MIT, permitiendo extender medidas de seguridad o integrar otras redes de anonimato. Mi Rol Condensé necesidades recurrentes de automatización en primitivas reutilizables, priorizando patrones de red resilientes y abstracciones amigables para desarrolladores. ...

Panorama del Proyecto Las operaciones de inventario de una marca peruana en expansión necesitaban una fuente única de información. Construí una herramienta logística de escritorio que mantiene sincronizados los niveles de stock, los movimientos y las alertas en toda la compañía. Contexto de Negocio Diseñado para reemplazar hojas de cálculo dispersas con un flujo guiado alineado a los procesos de Oasisdrinks. Permite a los supervisores visualizar rotación de productos, reabastecimientos pendientes y balances de almacén sin conciliaciones manuales. Capacidades Clave Vistas modulares en Java Swing para gestión de catálogo, recepción de compras y confirmación de despachos. Capa de dominio basada en MVC que separa las reglas de negocio de la presentación para iterar con rapidez. Persistencia en MySQL con salvaguardas transaccionales que evitan movimientos duplicados o fuera de sincronía. Acceso sensible a roles que mantiene las acciones críticas restringidas a operadores y responsables autorizados. Notas de Implementación Construido con un patrón DAO extensible, listo para una futura capa web o API. Incluye datos de prueba y scripts de entorno para que nuevos operadores prueben el flujo rápidamente. Entrega con licencia MIT y documentación clara para el traspaso al equipo de TI interno. Mi Rol Lideré todo el ciclo de vida: levantamiento de requerimientos con operaciones, diseño del modelo de interacción, desarrollo de la interfaz Swing y la capa de persistencia, y despliegue del piloto. ...

Panorama del Proyecto Los organizadores de buffets equilibran recetas, presupuestos y número de asistentes con plazos muy ajustados. Esta aplicación ofrece un espacio único donde chefs planifican menús, proyectan costos y ajustan cantidades sin depender de hojas de cálculo. Contexto de Negocio Diseñada para equipos de catering que necesitan simular menús día a día para grupos de cualquier tamaño. Conecta la gestión de inventarios con propuestas listas para el cliente al mostrar variaciones de costo en tiempo real. Capacidades Clave Compositor de menús dinámico que calcula el consumo de ingredientes por comida, por persona y para eventos de varios días. Motor de costos que combina lógica de planificación en Java con servicios Django para entregar presupuestos de compra precisos. Microservicio de gestión de usuarios (Django) ubicado en login_micro, con autenticación segura y tableros según el rol. Despliegue preparado para Kubernetes, con imágenes Docker y manifiestos para escalar sin fricción. Notas de Implementación Construido con Java 17+ y Python 3.9, orquestado mediante contenedores para entornos previsibles. Expone endpoints REST que pueden alimentar futuras extensiones móviles o kioscos. Licencia MIT con documentación clara para acelerar la adopción por parte del personal de cocina y finanzas. Mi Rol Lideré la arquitectura de la solución, implementé el motor de planificación en Java, desarrollé el servicio de autenticación en Django y preparé los activos DevOps para la orquestación con contenedores. ...

Panorama del Proyecto La venta de tickets a gran escala exige más que un monolito. Esta plataforma ofrece ventas tolerantes a fallos mediante un conjunto de servicios especializados, sincronizados con NATS JetStream y listos para desplegarse en Kubernetes. Contexto de Negocio Diseñado como blueprint para marketplaces que requieren flujos de compra y pago resilientes. Demuestra patrones de eventos probados, listos para evolucionar hacia entornos productivos de alta disponibilidad. Facilita la incorporación de equipos frontend gracias a un cliente Next.js moderno ya conectado a las APIs. Capacidades Clave Topología de microservicios que cubre autenticación, inventario de tickets, órdenes, pagos y expiraciones. Bus de eventos JetStream integrado en la aplicación para entregas como mínimo una vez sin infraestructura adicional. Acceso seguro con JWT empleando cookies HTTP-only y paquetes compartidos de validación en common/. Frontend responsivo con Next.js + Tailwind CSS, ofreciendo una experiencia de checkout premium. Expiraciones automatizadas que liberan tickets si el comprador abandona el proceso. Arquitectura Destacada Servicios dockerizados orquestados con Kubernetes y loops locales acelerados mediante Skaffold. MongoDB almacena datos transaccionales mientras Redis puede respaldar caché transitorio o replays de eventos. Paquetes TypeScript compartidos que mantienen coherentes los eventos, modelos y manejo de errores. Jest y Supertest protegen los flujos críticos mediante pruebas unitarias e integraciones. Notas de Implementación Prioriza código observable y mantenible: estructura modular, namespaces dedicados y middleware defensivo. Flujos de mensajería en tiempo real documentados para equipos que extienden la plataforma o integran nuevos canales. Fundamentos con licencia MIT que invitan a personalizar el sistema para corporativos o startups. Mi Rol Arquitecté el sistema distribuido, implementé los contratos de servicio y reforcé el tooling DevOps para que los equipos iteren rápido sin comprometer la confiabilidad. ...