WuKongIM /WuKongIM

More than just IM 不只是即时通讯(IM)

★ 5,001⑂ 716👁 33⑃ 488● 632▤ 66
GoApache-2.0Created 2023-05-09docs.githubim.com
Download: v2.2.5-20260422v2.2.5-20260422 ↓202604222026-04-22
+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

Latest release

v2.2.5-20260422 v2.2.5-20260422 2026-04-22

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON