Mayros

Gateway para qualquer sistema operacional para agentes de IA em WhatsApp, Telegram, Discord, iMessage e mais.
Envie uma mensagem, receba uma resposta do agente do seu bolso. Plugins adicionam Mattermost e mais.

🚀

Começar

Instale o Mayros e inicie o Gateway em minutos.

✨

Executar o Assistente

Configuração guiada com mayros onboard e fluxos de pareamento.

🖥️

Abrir a Interface de Controle

Lance o painel do navegador para chat, configuração e sessões.

O que é o Mayros?

Mayros é um gateway auto-hospedado que conecta seus aplicativos de chat favoritos — WhatsApp, Telegram, Discord, iMessage e mais — a agentes de codificação de IA como Pi. Você executa um único processo Gateway em sua própria máquina (ou servidor), e ele se torna a ponte entre seus aplicativos de mensagens e um assistente de IA sempre disponível.

Para quem é? Desenvolvedores e usuários avançados que desejam um assistente de IA pessoal que possam contatar de qualquer lugar — sem abrir mão do controle de seus dados ou depender de um serviço hospedado.

O que o torna diferente?

Auto-hospedado: executa em seu hardware, suas regras
Multi-canal: um Gateway atende WhatsApp, Telegram, Discord e mais simultaneamente
Nativo para agentes: construído para agentes de codificação com uso de ferramentas, sessões, memória e roteamento multi-agente
Código aberto: licença MIT, impulsionado pela comunidade

O que você precisa? Node 22+, uma chave de API (Anthropic recomendado) e 5 minutos.

Como funciona

mermaid
flowchart LR
  A["Apps de chat + plugins"] --> B["Gateway"]
  B --> C["Agente Pi"]
  B --> D["CLI"]
  B --> E["Interface de Controle Web"]
  B --> F["App macOS"]
  B --> G["Nodes iOS e Android"]

O Gateway é a única fonte de verdade para sessões, roteamento e conexões de canal.

Capacidades principais

🌐

Gateway multi-canal

WhatsApp, Telegram, Discord e iMessage com um único processo Gateway.

🔌

Canais de plugin

Adicione Mattermost e mais com pacotes de extensão.

🔀

Roteamento multi-agente

Sessões isoladas por agente, workspace ou remetente.

🖼️

Suporte a mídia

Envie e receba imagens, áudio e documentos.

🖥️

Interface de Controle Web

Painel do navegador para chat, configuração, sessões e nodes.

📱

Nodes móveis

Pareie nodes iOS e Android com suporte a Canvas.

Início rápido

Instalar o Mayros

bash
npm install -g mayros@latest

Integrar e instalar o serviço

bash
mayros onboard --install-daemon

Parear WhatsApp e iniciar o Gateway

bash
mayros channels login
mayros gateway --port 18789

Precisa da instalação completa e configuração de desenvolvimento? Consulte Início rápido.

Painel

Abra a Interface de Controle do navegador após o Gateway iniciar.

Padrão local: http://127.0.0.1:18789/
Acesso remoto: Superfícies web e Tailscale

Configuração (opcional)

A configuração fica em ~/.mayros/mayros.json.

Se você não fizer nada, o Mayros usa o binário Pi incluído no modo RPC com sessões por remetente.
Se você quiser restringir, comece com channels.whatsapp.allowFrom e (para grupos) regras de menção.

Exemplo:

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