Open Source · MIT Licensed

Your AI assistant,
everywhere you message

Zirkabot connects AI to WhatsApp, Telegram, Discord, and more. Self-hosted gateway with a Chrome extension for smart text actions.

Install Now View Source

# One-line install (requires Node 22+) curl -fsSL https://zirkabot.com/install.sh | bash

# Interactive install (migrate from Clawdbot/OpenClaw) curl -fsSL https://zirkabot.com/install.sh -o /tmp/install.sh bash /tmp/install.sh

# PowerShell (Run as Administrator) irm https://zirkabot.com/install.ps1 | iex

Everything you need

A single gateway that bridges AI to all your messaging platforms.

💬

Multi-Platform Gateway

Connect WhatsApp, Telegram, Discord, iMessage, and Mattermost through a single self-hosted Node.js gateway.

🧠

AI Agent Bridge

Route messages through AI agents with tool streaming, multi-agent routing, and per-sender isolated sessions.

🌐

Chrome Extension

Smart context menus for any text field. Fix spelling, improve writing, translate, and generate replies — directly in your browser.

🖥

Control Dashboard

Browser-based UI for chat, configuration, session management, and real-time monitoring of your gateway.

🔒

Self-Hosted & Private

Your data stays on your machine. Token-based auth, loopback-first network model, no third-party data collection.

📱

Site-Aware Actions

The Chrome extension detects Jira, GitHub, and Gmail to offer tailored AI actions — like writing acceptance criteria or suggesting email replies.

What is Zirkabot?

Zirkabot is an AI-powered personal assistant that runs on your own hardware. It connects to the messaging apps you already use — WhatsApp, Telegram, Discord, iMessage — and routes conversations through AI models like Claude or GPT.

🏠 Self-hosted Your data stays on your machine. No cloud required.

🔌 Multi-platform One gateway connects all your messaging channels.

🤖 AI-native Built-in support for Anthropic, OpenAI, and local models.

How it works

A single gateway process owns all channel connections.

WhatsApp / Telegram / Discord / iMessage | v +---------------------------+ | Zirkabot Gateway | ws://127.0.0.1:18789 | (Node.js process) | +-------------+-------------+ | +-----------+-----------+ | | | AI Agent CLI Dashboard (RPC) (zirkabot) (Browser UI)

Quick Start (5 minutes)

From zero to chatting with your AI assistant.

Install

curl -fsSL https://zirkabot.com/install.sh | bash

Requires Node.js 22+

Onboard

zirkabot onboard --install-daemon

Set up auth, channels, and start the gateway

Connect

zirkabot channels login

Scan QR code to link WhatsApp, or add Telegram bot token

Full Getting Started Guide →

Common Questions

Quick answers to get you started.

Do I need an API key?

Yes, you need credentials from at least one AI provider (Anthropic, OpenAI, etc). The onboard wizard helps you set this up.

Is it really self-hosted?

Yes. Zirkabot runs entirely on your machine. AI requests go directly to your chosen provider — no Zirkabot servers in between.

What if something breaks?

Run zirkabot status for diagnostics, or zirkabot doctor to auto-repair common issues.

Can I use local AI models?

Yes. Zirkabot supports Ollama and other local models. See the local models guide.

Which platforms are supported?

macOS, Linux, and Windows (via WSL2). The gateway runs on Node.js 22+.

Is WhatsApp allowed?

Zirkabot uses the WhatsApp Web protocol. Review WhatsApp's terms of service for your use case.

Full FAQ & Troubleshooting →

Your AI assistant,everywhere you message