Repolode
jigjoy-ai

jigjoy-ai/mozaik

Un runtime de TypeScript donde los agentes de IA se incorporan a un espacio compartido, reaccionan a eventos y se ejecutan en paralelo sin bloquearse entre sí.

Estrellas
166
Forks
18
Issues abiertos
4
Último commit
hace 8 horas

¿Qué es?

Mozaik es un runtime de TypeScript para crear agentes de IA que comparten un bus de eventos. Los participantes, como personas, agentes y observadores, se incorporan a un runtime, publican eventos como mensajes o señales personalizadas y reaccionan mediante manejadores de situaciones que combinan una especificación con un procesador.

Cada turno de un agente se ejecuta como una máquina de estados que abarca la recepción de mensajes, la inferencia del modelo, las llamadas a herramientas y la respuesta final. Las llamadas a runLoop no esperan a que termine la ejecución, por lo que varios agentes pueden razonar y usar herramientas al mismo tiempo. Un manejador de interceptación opcional puede inspeccionar o reescribir el siguiente estado antes de que se ejecute, lo que permite que una persona u otro agente dirija el bucle.

El paquete se publica en npm como @mozaik-ai/core. El proveedor se selecciona según el nombre del modelo que se pasa a runInference; las credenciales de OpenAI, Anthropic y Gemini se leen de variables de entorno, y se puede acceder a DeepSeek mediante un endpoint compatible con OpenAI.

Funciones clave

  • 01Los participantes (personas, agentes y observadores) se incorporan a un runtime compartido e intercambian SpaceEvents.
  • 02Los bucles de los agentes se ejecutan en paralelo y cada uno tiene su propio loopId.
  • 03Las especificaciones y los procesadores de situaciones permiten que los agentes reaccionen a eventos sin consultar continuamente si hay novedades.
  • 04Los estados integrados del bucle abarcan la inferencia, la generación en streaming, las llamadas a herramientas y las respuestas del modelo.
  • 05Un manejador de interceptación puede reescribir la siguiente transición del bucle antes de que se ejecute.
  • 06El estado compartido se tipa mediante una subclase de RuntimeState.

Casos de uso

  • Crear sistemas multiagente en los que varios agentes colaboran en tiempo real para alcanzar un mismo objetivo.
  • Añadir un agente crítico o revisor que reaccione a las respuestas de otro agente.
  • Crear una transcripción o un flujo para la interfaz de usuario observando eventos, sin participar en la conversación.
  • Mantener a una persona al tanto del proceso interceptando las llamadas a herramientas antes de que se ejecuten.

Inicio rápido

  1. 1

    Instala el paquete principal con npm

    npm install @mozaik-ai/core
  2. 2

    Configura en un archivo .env la clave API del proveedor que uses

Antes de usarlo

  • Para ejecutar la inferencia se necesitan claves API de proveedores de modelos como OpenAI, Anthropic o Gemini.
  • El fragmento del README no incluye un ejemplo ejecutable de principio a fin, por lo que la configuración posterior a la instalación puede requerir cierto esfuerzo.

En colecciones

Temas

Preguntas frecuentes

¿Qué es mozaik?
Un runtime de TypeScript donde los agentes de IA se incorporan a un espacio compartido, reaccionan a eventos y se ejecutan en paralelo sin bloquearse entre sí. Mozaik es un runtime de TypeScript para crear agentes de IA que comparten un bus de eventos. Los participantes, como personas, agentes y observadores, se incorporan a un runtime, publican eventos como mensajes o señales personalizadas y reaccionan mediante manejadores de situaciones que combinan una especificación con un procesador.
¿mozaik es gratuito? ¿Qué licencia tiene?
mozaik es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mozaik sigue mantenido?
Mantenimiento activo. El último commit de mozaik fue el 7 nov 2026.
¿Para qué puedo usar mozaik?
Crear sistemas multiagente en los que varios agentes colaboran en tiempo real para alcanzar un mismo objetivo. Añadir un agente crítico o revisor que reaccione a las respuestas de otro agente. Crear una transcripción o un flujo para la interfaz de usuario observando eventos, sin participar en la conversación. Mantener a una persona al tanto del proceso interceptando las llamadas a herramientas antes de que se ejecuten.
¿Cómo se instala mozaik?
Instala el paquete principal con npm: npm install @mozaik-ai/core Configura en un archivo .env la clave API del proveedor que uses
¿Dónde consigo mozaik?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/jigjoy-ai/mozaik

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados