Mayros

Gateway para cualquier sistema operativo que conecta agentes de IA a WhatsApp, Telegram, Discord, iMessage y más.
Envía un mensaje y obtén una respuesta del agente desde tu bolsillo. Los plugins añaden Mattermost y más.

🚀

Comenzar

Instala Mayros y levanta el Gateway en minutos.

✨

Ejecutar el Asistente

Configuración guiada con mayros onboard y flujos de emparejamiento.

🖥️

Abrir la UI de Control

Abre el panel de control del navegador para chat, configuración y sesiones.

¿Qué es Mayros?

Mayros es un gateway autoalojado que conecta tus aplicaciones de chat favoritas — WhatsApp, Telegram, Discord, iMessage y más — a agentes de codificación de IA como Pi. Ejecutas un único proceso Gateway en tu propia máquina (o un servidor), y se convierte en el puente entre tus aplicaciones de mensajería y un asistente de IA siempre disponible.

¿Para quién es? Desarrolladores y usuarios avanzados que desean un asistente de IA personal al que puedan enviar mensajes desde cualquier lugar — sin renunciar al control de sus datos ni depender de un servicio alojado.

¿Qué lo hace diferente?

Autoalojado: se ejecuta en tu hardware, tus reglas
Multicanal: un Gateway sirve WhatsApp, Telegram, Discord y más simultáneamente
Nativo para agentes: construido para agentes de codificación con uso de herramientas, sesiones, memoria y enrutamiento multiagente
Código abierto: licencia MIT, impulsado por la comunidad

¿Qué necesitas? Node 22+, una clave API (se recomienda Anthropic) y 5 minutos.

Cómo funciona

mermaid
flowchart LR
  A["Apps de chat + plugins"] --> B["Gateway"]
  B --> C["Agente Pi"]
  B --> D["CLI"]
  B --> E["UI de Control Web"]
  B --> F["App macOS"]
  B --> G["Nodos iOS y Android"]

El Gateway es la única fuente de verdad para sesiones, enrutamiento y conexiones de canales.

Capacidades clave

🌐

Gateway multicanal

WhatsApp, Telegram, Discord e iMessage con un único proceso Gateway.

🔌

Canales de plugins

Añade Mattermost y más con paquetes de extensión.

🔀

Enrutamiento multiagente

Sesiones aisladas por agente, espacio de trabajo o remitente.

🖼️

Soporte multimedia

Envía y recibe imágenes, audio y documentos.

🖥️

UI de Control Web

Panel de control del navegador para chat, configuración, sesiones y nodos.

📱

Nodos móviles

Empareja nodos iOS y Android con soporte Canvas.

Inicio rápido

Instalar Mayros

bash
npm install -g mayros@latest

Incorporar e instalar el servicio

bash
mayros onboard --install-daemon

Emparejar WhatsApp e iniciar el Gateway

bash
mayros channels login
mayros gateway --port 18789

¿Necesitas la instalación completa y configuración de desarrollo? Consulta Inicio rápido.

Panel de control

Abre la UI de Control del navegador después de que el Gateway se inicie.

Predeterminado local: http://127.0.0.1:18789/
Acceso remoto: Superficies web y Tailscale

Configuración (opcional)

La configuración vive en ~/.mayros/mayros.json.

Si no haces nada, Mayros usa el binario Pi incluido en modo RPC con sesiones por remitente.
Si quieres asegurarlo, comienza con channels.whatsapp.allowFrom y (para grupos) reglas de mención.

Ejemplo:

json5
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@mayros"] } },
}