Self-Hosted IM Infrastructure

The easiest way to own your IM infrastructure

Deploy once. Run it standalone, or embed it anywhere.

On your own server, under your own domain — run a messaging system that's entirely yours.

yimsg private server, embedded chat interface, and responsive mobile layout
01Deploy Once

一次部署,多地、多端共用一套私有 IM

只需将 yimsg 部署到一台自己的机器,办公室、分支机构、居家和移动端即可通过局域网或公网连接同一套服务; 多个网站或业务系统也能同时嵌入。用户、消息、文件和数据全部由自己掌控。

One private server serving multiple locations and devices
  • 私有化部署
  • 完整 Web IM
  • 自有域名访问
  • 独立用户与组织体系
  • 数据自主掌控
  • 办公室、分支机构、居家与移动端共用
  • 支持局域网与公网访问

一台机器,一次部署,多地、多端、多个产品共用。

1 Machine
Minimal self-hosted, ready out of the box
2-core 4GB
Easily supports 100+ concurrent users
< 32MB
Ultra-compact deployment package
0 Third-Party Cloud
All data stays under your control

One-command start

Windows x86-64
curl.exe -L -o yimsg.zip https://github.com/dacez/yimsg/releases/download/v0.1.2/yimsg-0.1.2-windows-x86_64.zip; Expand-Archive yimsg.zip -DestinationPath .; Rename-Item yimsg-0.1.2-windows-x86_64 yimsg; cd yimsg; .\yimsg.exe
Linux x86-64
curl -fsSL -o yimsg.tar.gz https://github.com/dacez/yimsg/releases/download/v0.1.2/yimsg-0.1.2-linux-x86_64.tar.gz && mkdir yimsg && tar -xzf yimsg.tar.gz -C yimsg --strip-components=1 && cd yimsg && ./yimsg
Linux ARM64
curl -fsSL -o yimsg.tar.gz https://github.com/dacez/yimsg/releases/download/v0.1.2/yimsg-0.1.2-linux-arm64.tar.gz && mkdir yimsg && tar -xzf yimsg.tar.gz -C yimsg --strip-components=1 && cd yimsg && ./yimsg
macOS Apple Silicon
curl -fsSL -o yimsg.tar.gz https://github.com/dacez/yimsg/releases/download/v0.1.2/yimsg-0.1.2-macos-arm64.tar.gz && mkdir yimsg && tar -xzf yimsg.tar.gz -C yimsg --strip-components=1 && cd yimsg && ./yimsg

The command downloads, extracts, and starts yimsg in one step. Once it’s running, open http://127.0.0.1:38081/ in a browser. No configuration file is required by default. To allow other devices on a LAN or the public internet to connect, run "yimsg --listen 0.0.0.0:38081". Each package also bundles yimsg-cli and yimsg-agent, two optional command-line tools.

02Embed Anywhere

一行代码,为任何网站增加即时通讯能力

将 yimsg 嵌入现有网站、管理后台、SaaS 产品或企业业务系统。 无需重新开发消息连接、会话同步、联系人、群组、文件和消息状态。

  • Shadow DOM 样式隔离,不影响宿主页面
  • 支持浅色 / 深色 / 跟随系统主题
  • 多语言联动,跟随宿主页面语言切换
  • 一套服务,多个网站或业务系统同时复用
import * as YimsgUIKit from '/uikit/yimsg-uikit.js';

const host = document.getElementById('chat-host');
const handle = YimsgUIKit.mount(host, {
  wsUrl: 'wss://your-domain.com/ws',
  uploadUrl: '/api/upload',
  theme: 'auto',
});

示例代码,实际接入时请替换为你自己的域名、上传接口与容器节点;需先自行构建 UIKit 产物。

Deploy once. Embed everywhere.

The same chat interface embedded into multiple products
AI Customer Service

Easily build multi-role intelligent customer service

Give each agent identity its own private knowledge base, plus a knowledge base shared by every agent — yimsg-agent polls for new messages around the clock and replies automatically, no extra frontend code required.

Three AI customer service agents, each with a private knowledge base, connected to one shared knowledge base
  • 👩‍💼 账号客服-小美账号与登录相关问题:找回密码、多端登录、拉黑与屏蔽。
  • 🧑‍💻 接入客服-小林开发者接入相关问题:UIKit 嵌入、SDK 集成。
  • 🛠️ 值班客服-阿强故障处理相关问题,需要时可升级给人工技术支持。
  • ➕ 支持自定义客服角色按业务需要新增任意多个专精角色,各自配置独立私有知识库。

Private knowledge base + shared knowledge base — add as many specialized agents as you need.

03Customize Everything

Open UIKit and SDK — ship chat your way

用户可以直接使用 yimsg 提供的完整聊天界面,也可以基于开放能力构建自己的产品。

  • 使用 UIKit 快速接入完整聊天界面
  • 使用 SDK 构建自定义客户端
  • 使用 API 连接现有业务系统路线图
  • 自定义品牌、主题和交互
  • 扩展机器人、AI 和业务消息路线图
  • 对接自己的登录和用户体系路线图

Use our UI, customize it, or build your own.

UIKit, SDK, and WebSocket building blocks customized into multiple chat experiences
Hardware Appliance

Meet the yimsg Box

yimsg Box is a compact appliance for even simpler private deployment. Pictured is the actual unit we bought, deployed, and run ourselves — you can run the same software on your own machine too.

Photo of the actual yimsg Box mini host
  • Designed for local network use
  • Data stays on a device you control
  • Compact all-in-one mini host
  • No public IP required for LAN use
  • Optional access through your own domain
  • Secure internet access path Roadmap

One Box. Your Own IM.

Use Cases

One UIKit, many ways to use it

The same chat capability works fully out of the box, embeds into your own product on demand, and adapts to both mobile and desktop.

🤖

Intelligent customer service widget

Embed the yimsg UIKit into your website or admin panel with one line of code — give each agent identity its own private knowledge base, auto-replied by yimsg-agent, and visitors can start a temporary chat anytime, without registering or adding a friend.

Try the intelligent customer service widget →
🧑‍💻

Human agent workbench

One agent can staff 6 support accounts on a single screen: when a small team shares one seat across multiple stores or channels, all 6 customer conversations reply directly, side by side, with no switching logins.

Try the human agent workbench →
🖥️

Standalone web app

Also works as a complete, standalone web IM app on its own — log in to send messages and manage contacts and groups, with no extra development needed.

Try the full enterprise IM →
👥

Contacts + org chart

Friends and a complex org chart are unified into one contacts page — a sample organization with 4 department levels and about 76 people, all visible at a glance, with full bottom navigation between chat / contacts / settings.

Try the org contacts view →
💾

Local persistence

The client supports local persistent caching — refreshing the page or reconnecting after a dropped connection never loses your conversations. This demo signs you in automatically, no registration needed.

Try local persistence →
📱

Mobile / desktop adaptive

The same UIKit automatically adapts to mobile and desktop layouts: bottom navigation with single-column switching on mobile, sidebar navigation with multi-column layout on desktop — no separate build per device.

Try the mobile / desktop views →