omni

Universal event-driven omnichannel messaging platform

One API to send and receive messages across WhatsApp, Discord, Telegram, and more.
CLI-first. Event-driven. Built for AI agents.

Install • Quick Start • AI Agents • CLI • API • SDKs • Development

Think of Omni as a deep-sea octopus. Each channel is a tentacle — WhatsApp, Discord, Telegram — reaching into a different messaging ecosystem. Events are nerve impulses flowing through NATS JetStream. The core is the brain — identity resolution, event routing, and a unified API that lets you treat all channels as one.

Why Omni?

Channels

Install

Quickest (npm)

bun add -g @automagik/omni
omni install              # interactive wizard: sets up server + PM2

Migrating from @omni/cli? Run bun remove -g @omni/cli first.

Via install script (npm-first, git fallback)

curl -fsSL https://raw.githubusercontent.com/automagik-dev/omni/main/install-client.sh | bash

Full server from source

curl -fsSL https://raw.githubusercontent.com/automagik-dev/omni/main/install.sh | bash

Three modes: CLI only · Full server · CLI + connect to remote

# CLI only (tries npm first, falls back to git clone)
curl -fsSL https://raw.githubusercontent.com/automagik-dev/omni/main/install.sh | bash -s -- --cli

# CLI + connect to remote
curl -fsSL https://raw.githubusercontent.com/automagik-dev/omni/main/install.sh | bash -s -- --cli https://your-omni-server.com

# Full server
curl -fsSL https://raw.githubusercontent.com/automagik-dev/omni/main/install.sh | bash -s -- --server

git clone https://github.com/automagik-dev/omni.git && cd omni
make setup    # Install deps, create .env, start services

Quick Start

# Authenticate
omni auth login --api-key <your-key>

# WhatsApp — scan QR
omni instances create --name "my-whatsapp" --channel whatsapp-baileys
omni instances qr <id> --watch

# Discord — connect bot
omni instances create --name "my-discord" --channel discord
omni instances connect <id> --token "BOT_TOKEN"

# Telegram — connect bot
omni instances create --name "my-telegram" --channel telegram
omni instances connect <id> --token "BOT_TOKEN"

# Send messages
omni send --to "+5511999999999" --text "Hello from the deep 🐙"

# Browse conversations
omni chats list --unread --sort unread

AI Agents

Connect any LLM provider and your instances become intelligent agents — responding to messages, reacting to events, across every channel.

Message received → NATS event → Agent Dispatcher → Provider (OpenAI/Agno/Webhook) → Humanized reply

# Connect a provider
omni providers create --name "my-llm" --schema openai --base-url "https://api.openai.com/v1" --api-key "sk-..."

# Bind to instance — it's now an agent
omni instances update <id> --agent-provider <provider-id>