WuKongIM: A Go repository from yqchilde

WuKongIM (Make information transfer easier)

9 years of accumulation, precipitated a high-performance universal communication service,message center, supporting instant messaging, message push, IoT communication, audio and video signaling, live broadcast barrage, customer service system, AI communication, instant community and other scenarios.

(Note: This project is a general underlying instant messaging service. The upper layer needs to dock with its own specific business system (which can be easily docked with its own business system through the webhook and datasource mechanism). The core of this project mainly maintains a large number of long connections of clients and delivers messages according to the message rules of third-party business systems.)

This project needs to be compiled in a go1.20.0 or higher version.

中文文档

Website: https://githubim.com
Protocol: WuKongIM Protocol
Issues: https://github.com/WuKongIM/WuKongIM/issues
Docs: https://githubim.com

Demo

Chat Demo

Demo Source： https://github.com/WuKongIM/WuKongIMJSSDK/tree/main/examples

Web chat scene demo: http://imdemo.githubim.com

Backend monitoring demo: http://monitor.githubim.com/web

Features

📚 Fully self-developed: WuKongIM uses a self-developed message database, binary protocol, and network library, and supports custom protocols.
🚀 High performance: WuKongIM can handle millions of online users and has a throughput of 160,000 messages per second (including database operations).
🔔 Zero dependencies: WuKongIM has no third-party dependencies and is easy to deploy.
🔐 Security: WuKongIM encrypts both message channels and message content to prevent man-in-the-middle attacks and message tampering.
🧱 Highly extensible: WuKongIM uses a channel-based design and currently supports group and point-to-point channels. It can be extended to support custom channels for use cases such as chatbots and customer service.

TODO

Quick Start

Docker Deployment

docker run -d -p 5001:5001 -p 5100:5100 -p 5172:5172 -p 5200:5200 -p 5210:5210 -p 5300:5300  --name wukongim -v ./wukongim:/root/wukongim  wukongim/wukongim:v1.2

Binary Deployment

wget -O wukongim https://github.com/WuKongIM/WuKongIM/releases/download/v1.2.1/wukongim-linux-amd64  # For other systems, please check https://github.com/WuKongIM/WuKongIM/releases

chmod +x wukongim

Start

./wukongim --config config/wk.yaml

Source code

git clone https://github.com/WuKongIM/WuKongIM.git

cd WuKongIM

go run main.go --config config/wk.yaml

Configuration server information (context)

View System information: http://127.0.0.1:5001/varz

View Monitor information: http://127.0.0.1:5300/web

Demo: http://127.0.0.1:5172/chatdemo

For more deployment options, see the documentation.

Port explanation:

5001: API port
5100: TCP long connection port
5172: Demo port
5200: WebSocket long connection port
5300: Monitoring system port

SDK source code and demos

Project Name	Github Address	Example	Documentation	Description
WuKongIM	Github	无	Documentation	WuKongIM communication end, responsible for long connection maintenance, message delivery, etc.
WuKongIMAndroidSDK	Github	Example	Documentation	WuKongIM's Android SDK
WuKongIMiOSSDK	Github	Example	Documentation	WuKongIM's iOS SDK
WuKongIMUniappSDK	Github	Example	Documentation	WuKongIM's Uniapp SDK
WuKongIMJSSDK	Github	Example	Documentation	WuKongIM's JS SDK
WuKongIMFlutterSDK	Github	Example	Documentation	WuKongIM's Flutter SDK
WuKongIMReactNativeDemo	Github	None	None	WuKongIM's React Native Demo (provided by contributor wengqianshan)

Illustration

Architecture

Business System Integration

Webhook

Applicable Scenarios

Instant Messaging

Supports group channels
Supports personal channels
Supports permanent message storage
Supports offline message push
Supports recent conversation maintenance

Message Push/Site Message

Supports group channels
Supports personal channels
Supports offline message push

IoT Communication

Supports MQTT protocol (to be developed)
Supports publish and subscribe

Audio and Video Signaling Server

Supports temporary command message delivery

Live Broadcast Bullet Screens

Supports temporary message delivery
Supports temporary subscriber support

Customer Service System

Supports customer service channels
Messages can be delivered to third-party servers
Third-party servers can decide to allocate designated subscribers to deliver messages in groups

Real-time AI Feedback

Supports pushing messages sent by clients to third-party servers, and the results returned by AI after being fed back by third-party servers are pushed back to clients

Instant Community

Supports community channels
Supports message delivery in topic mode

Monitor

Star

Our team has been committed to the research and development of instant messaging. We need your encouragement. If you find this project helpful, please give it a star. Your support is our greatest motivation.

Case

Project

TangSengDaoDao

Github

https://github.com/TangSengDaoDao/TangSengDaoDaoServer

Screenshot

Wechat

If necessary, add me and I will invite you to the group. My WeChat ID is wukongimgo.

License

WuKongIM is licensed under the Apache License 2.0.

yqchilde/WuKongIM