+0
Daily
5,001
stars
716
forks
33
watchers
488
prs
632
issues
66
releases
README
WuKongIM Real-time messaging. Your infrastructure. Your product. Open-source messaging for chat, notifications, and AI conversations. Built-in storage and clustering. No external database, cache, or message queue required. Quick start · Demo home · Showcase · Documentation · 简体中文 WuKongIM handles connections, message storage, synchronization, presence, and online delivery. Build your own experience on top: personal and group chat, customer support, application notifications, or streaming AI replies. Your application owns the UI, accounts, and business rules. Why WuKongIM? | Capability | What it gives you | | --- | --- | | Self-contained messaging core | Built-in message, metadata, and replication storage; fewer services to deploy and operate. | | One cluster model | Start with a single-node cluster, then deploy multiple nodes using the same messaging model. 256 hash slots by default. | | Messaging building blocks | Per-channel ordering, offline synchronization, multi-device sessions, and personal, group, or custom channels. | | Tools you can use immediately | Six runnable demos, an embedded Manager, metrics, diagnostics, and backup tools. | [!NOTE] v3 is in beta. APIs, configuration, and durable formats may change. Review the upgrade guidance before changing versions; check installed packages with wukongim version. Built with WuKongIM TangSengDaoDao · 唐僧叨叨 An open-source, self-hosted messaging application. TangSengDaoDao provides chat applications for iOS, Android, Web, Windows, macOS, and Ubuntu Linux, helping enterprises run their own messaging service. WuKongIM powers its persistent connections, message delivery, and storage. TangSengDaoDao builds the product experience on top, including chat interfaces, contacts, groups, and other business features—a concrete example of using WuKongIM as the messaging core of a complete application. Website · Source code and architecture Quick start Open the Demo home page to try all six demos in your browser: chat, streaming replies, customer support, Agent, MQTT smart store, and live product launch. To run them on your own computer, follow the steps below. 1. Run the demos on your computer Requires Go 1.26+, Node.js 22.12+ or 20.19+, and npm. From a fresh checkout: bash git clone https://github.com/WuKongIM/WuKongIM.git cd WuKongIM node demo/start.mjs Already have the repository? Run node demo/start.mjs from its root. The launcher builds the server, prepares the demo backends, and opens the demo home page when ready. It starts a single-node cluster with 256 hash slots; all services listen on loopback. The default model is simulated, so no model API key is needed. The first run downloads Go and npm dependencies. | Demo | Explore | Source and guide | | --- | --- | --- | | Chat | Direct and group conversations, message editing, and history recovery | Chat Demo | | Streaming replies | Incremental replies, model integration, cancellation, and failu
Top issues
#1050[chat-lifecycle] chat-20261028T021756Z-947172ac7 comments · 2026-10-28#1040[chat-lifecycle] chat-20261026T001807Z-310bed0f6 comments · 2026-10-26#557IM 内部单节点 Raft 状态卡住6 comments · 2026-06-30#1046[chat-lifecycle] chat-20261027T024556Z-becab94d5 comments · 2026-10-27#510/conversation/sync 接口返回数据不全5 comments · 2026-02-07#178使用WuKongIM的项目5 comments · 2024-09-12#1067多端登录4 comments · 2026-11-01#1054[chat-lifecycle] chat-20261028T064839Z-88eaef8c4 comments · 2026-10-28