Mayros

Gateway multi-OS per agenti AI su WhatsApp, Telegram, Discord, iMessage e altro.
Invia un messaggio, ricevi una risposta dall'agente direttamente dalla tua tasca. I plugin aggiungono Mattermost e altro.

🚀

Inizia

Installa Mayros e avvia il Gateway in pochi minuti.

✨

Esegui il Wizard

Configurazione guidata con mayros onboard e flussi di pairing.

🖥️

Apri la Control UI

Avvia la dashboard browser per chat, configurazione e sessioni.

Cos'è Mayros?

Mayros è un gateway self-hosted che connette le tue app di chat preferite — WhatsApp, Telegram, Discord, iMessage e altro — ad agenti AI di programmazione come Pi. Esegui un singolo processo Gateway sulla tua macchina (o su un server), e diventa il ponte tra le tue app di messaggistica e un assistente AI sempre disponibile.

Per chi è? Sviluppatori e power user che vogliono un assistente AI personale a cui inviare messaggi da qualsiasi luogo — senza rinunciare al controllo dei propri dati o affidarsi a un servizio ospitato.

Cosa lo rende diverso?

Self-hosted: funziona sul tuo hardware, con le tue regole
Multi-canale: un Gateway serve WhatsApp, Telegram, Discord e altro simultaneamente
Nativo per agenti: costruito per agenti di programmazione con uso di strumenti, sessioni, memoria e routing multi-agente
Open source: licenza MIT, guidato dalla community

Di cosa hai bisogno? Node 22+, una chiave API (Anthropic consigliata) e 5 minuti.

Come funziona

mermaid
flowchart LR
  A["App di chat + plugin"] --> B["Gateway"]
  B --> C["Agente Pi"]
  B --> D["CLI"]
  B --> E["Control UI Web"]
  B --> F["App macOS"]
  B --> G["Node iOS e Android"]

Il Gateway è l'unica fonte di verità per sessioni, routing e connessioni ai canali.

Capacità principali

🌐

Gateway multi-canale

WhatsApp, Telegram, Discord e iMessage con un singolo processo Gateway.

🔌

Canali plugin

Aggiungi Mattermost e altro con pacchetti di estensione.

🔀

Routing multi-agente

Sessioni isolate per agente, workspace o mittente.

🖼️

Supporto media

Invia e ricevi immagini, audio e documenti.

🖥️

Control UI Web

Dashboard browser per chat, configurazione, sessioni e nodi.

📱

Nodi mobili

Abbina nodi iOS e Android con supporto Canvas.

Avvio rapido

Installa Mayros

bash
npm install -g mayros@latest

Esegui l'onboarding e installa il servizio

bash
mayros onboard --install-daemon

Abbina WhatsApp e avvia il Gateway

bash
mayros channels login
mayros gateway --port 18789

Hai bisogno dell'installazione completa e della configurazione di sviluppo? Vedi Avvio rapido.

Dashboard

Apri la Control UI browser dopo l'avvio del Gateway.

Predefinito locale: http://127.0.0.1:18789/
Accesso remoto: Superfici web e Tailscale

Configurazione (opzionale)

La configurazione si trova in ~/.mayros/mayros.json.

Se non fai nulla, Mayros utilizza il binario Pi incluso in modalità RPC con sessioni per mittente.
Se vuoi bloccarlo, inizia con channels.whatsapp.allowFrom e (per i gruppi) regole di menzione.

Esempio:

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