Skip to content

DevCop95/devteams

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dev Teams · AI Operations Hub

Status Build Three.js Groq License

Una oficina 3D interactiva con ocho agentes de IA. Con una arquitectura modular y limpia, funciona en modo demo sin credenciales y escala a respuestas reales en cuanto conectas una API key de Groq.


Vista general

Portada


Qué incluye

Escena 3D

  • Ocho agentes con personalidad, rol y área de trabajo propia: Ana (CEO), Sofía (PM), Yared (Founder & Architect), Diego (FE), Marta (QA), Luis (DevOps), Valentina (UX) y Andrés (Data)
  • Pathfinding A* con Web Worker
  • Sombras dinámicas, ciclo día/noche, modo FPS, clima real de Cartagena vía Open-Meteo
  • Eventos ambientales: delivery, pausas, ping pong, visitante Paula

Panel lateral

  • Árbol — jerarquía del equipo con estado en tiempo real
  • Flujo — pasos MCP por agente con métricas de tokens y costo
  • Consola — chat individual o broadcast inteligente
  • Estado — actividad global con gráfica de 60 segundos
  • Dashboard — KPIs ejecutivos, decisiones compartidas y salud operativa

Chat y multiagente

  • Routing automático al agente más relevante por tema
  • Planner interno para consultas complejas
  • Delegación entre roles con flechas de flujo
  • Compresión automática de memoria cuando el historial crece
  • Modo broadcast: selecciona los roles adecuados en lugar de disparar a todos

Workspace (File System Access API)

  • Conexión a carpeta local sin subir nada a ningún servidor
  • Lectura de .txt, .md, .json, .js, .ts, PDF, Excel y Word
  • Búsqueda en texto plano a través del proyecto
  • Análisis de archivos por rol activo usando Groq

Últimas Optimizaciones (Performance & UI)

  • Carga optimizada: Renderizado inicial asíncrono (chunking) para evitar congelamientos en la pantalla de bienvenida.
  • Cero Lag (Shaders): Pre-alojamiento de luces dinámicas de eventos para evitar pesadas recompilaciones en Three.js.
  • FPS estables: Distribución de carga matemática (staggering) al actualizar texturas de monitores para garantizar fluidez.
  • Mejor iluminación: Escena 10% más clara y vibrante (LinearToneMapping) con código Three.js modernizado y sin warnings.
  • UI Glassmorphism: Rediseño total de modales y popups con bordes redondeados, sombras profundas y desenfoque de fondo.

Cómo ejecutar

Cualquier servidor estático local funciona. La forma más rápida:

python -m http.server 5500

Luego abre http://localhost:5500 en el navegador.

También puedes usar Live Server, Vite, npx serve o cualquier equivalente.

Nota: para los comandos de workspace (/carpeta, /leer, etc.) necesitas un navegador basado en Chromium. Firefox no soporta showDirectoryPicker todavía.


Conectar Groq

  1. Abre la app y pulsa el botón API en la cabecera.
  2. Elige el modelo desde el selector.
  3. Pega tu API key (la consigues gratis en console.groq.com).
  4. Pulsa Guardar.

La app valida la key con una llamada real antes de confirmar la conexión. Si falla, vuelve a modo demo automáticamente. La key se guarda en sessionStorage y nunca toca ningún backend propio.

Modelos disponibles

Identificador Descripción
llama-3.3-70b-versatile Default equilibrado
llama-3.1-8b-instant Respuestas más rápidas
meta-llama/llama-4-maverick-17b-128e-instruct Mayor razonamiento
moonshotai/kimi-k2-instruct-0905 Contexto de 256K
groq/compound Búsqueda en tiempo real

Comandos del chat

Escribe cualquiera de estos directamente en el input de la consola:

/carpeta          Conecta una carpeta local
/indexar          Reconstruye el índice de archivos
/archivos         Lista los archivos detectados
/leer ruta        Lee un archivo y lo abre en el visor
/buscar texto     Busca coincidencias en el workspace
/analizar ruta    Analiza un archivo con Groq desde el rol activo
/exportar         Descarga el chat actual como .txt

El mini menú de herramientas en la consola expone las mismas acciones sin tener que escribir comandos.


Atajos de teclado

Tecla Acción
Space Siguiente paso del flujo
R Reset de la simulación
M Iniciar reunión de equipo
F Activar / salir de modo FPS
N Alternar día / noche
A Auto play del flujo activo
C Resetear cámara
? Mostrar atajos
Esc Cerrar modales / salir de FPS

Estructura del proyecto

.
├── index.html          # Estructura HTML y contenedores de UI
├── css/
│   └── styles.css      # Todos los estilos visuales (Layout, Animaciones)
├── js/
│   ├── main.js         # Punto de entrada e inicialización
│   └── modules/
│       ├── api.js      # Lógica de Groq, Prompts y Planificador
│       ├── audio.js    # Efectos de sonido y música generativa
│       ├── scene.js    # Motor Three.js, Luces y Clima
│       ├── navigation.js # Sistema de Pathfinding A*
│       ├── workspace.js # Acceso a archivos locales (PDF, Office, TXT)
│       ├── agents.js   # Lógica de Agentes, Sub-agentes y Visitantes
│       └── ui.js       # Dashboard, Modales, Consola y Estado
└── README.md

La app ha sido refactorizada para ser modular y mantenible. No hay build step, no hay dependencias npm, no hay backend. Todo lo que necesitas está en los módulos y en las CDN declaradas en el index.html.


Stack

  • Three.js r128 — escena 3D, materiales, luces y sombras
  • Chart.js 4 — métricas en el panel de estado
  • PDF.js — lectura de archivos PDF locales
  • SheetJS (xlsx) — lectura de hojas de cálculo
  • Mammoth.js — extracción de texto de archivos Word
  • Groq API — inferencia LLM (llama 4, kimi k2 y otros)
  • File System Access API — acceso a carpetas locales sin subir archivos
  • Web Workers — pathfinding A* fuera del hilo principal
  • Web Speech API — entrada de voz en la consola

Persistencia

Dato Dónde se guarda
API key sessionStorage (no persiste entre sesiones)
Modelo seleccionado localStorage
Historial de chat por agente localStorage
Historial de reuniones localStorage
Historial de tareas localStorage
XP y niveles localStorage
Logros localStorage
Notas del pizarrón localStorage
Decisiones compartidas localStorage

Seguridad y privacidad

Esta versión está pensada para uso local y demos. Algunas consideraciones para uso en producción o en red:

  • Las llamadas a Groq se hacen directamente desde el navegador. En un entorno público, mueve esas llamadas a un backend para no exponer la key.
  • Los archivos del workspace nunca salen del navegador. La lectura es enteramente local.
  • No se envía telemetría ni datos a ningún servicio propio.

Limitaciones conocidas

  • El modo FPS con pointer lock puede comportarse diferente según el navegador.
  • Algunos flujos de visitantes (delivery, Paula) están en iteración y pueden requerir ajustes finos.
  • La compresión de memoria del chat es automática pero no es perfecta para conversaciones muy largas.

Créditos

Construido desde cero en Cartagena de Indias 🇨🇴 por Yared Henriquez, Founder & Architect de Dev Teams.


Licencia

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages