El proyecto agent-loop-visualizer es una herramienta educativa diseñada para demostrar el funcionamiento interno de los bucles de agentes de inteligencia artificial de manera visual e intuitiva. A diferencia de las interfaces de chat estándar que muestran solo la pregunta y la respuesta, este sistema descompone el proceso en cada paso, permitiendo al usuario observar cómo el modelo propone acciones y cómo el entorno las ejecuta hasta que se detiene.
La aplicación funciona en el navegador del usuario, ejecutando modelos locales como Google Gemma 4 E2B o Qwen3.5-0.8B mediante la librería Hugging Face transformers. Esto permite acceder a datos técnicos en tiempo real, como las probabilidades de cada token generado, los tokens especiales y la velocidad de decodificación. El diseño de la interfaz se alinea con la lectura 'Unit 01' del curso Agent Atlas, mapeando cada sección técnica (contexto, modelo, harness, entorno, parada) con un diagrama interactivo.
Entre sus funcionalidades destacan la capacidad de adjuntar archivos multimedia (imágenes, videos, audio) que se convierten en secuencias de tokens en el contexto, y la opción de permitir que el modelo escriba código ejecutable en un entorno sandbox de Docker. El proyecto requiere macOS con Apple Silicon, Linux con CUDA o CPU, y al menos 16 GB de RAM para los modelos más grandes. Está licenciado bajo Apache 2.0 y está orientado a estudiantes y desarrolladores que buscan comprender la arquitectura técnica de los agentes de IA sin depender de APIs externas.
