Bytedesk - Chat as a Service

AI powered Omnichannel customer service With Team Cooperation

Language

• English
• 中文

Introduction

TeamIM

• Multi-level organizational structure
• Role management
• Permission management
• ...

Customer Service

• Support multiple channels
• multiple routing strategies, and detailed assessment indicators
• Seating workbench
• ...

Knowledge Base

• Internal Docs
• HelpCenter
• FAQ

Ticket

• Ticket management
• Ticket SLA management
• Ticket statistics and reports
• ...

AI Agent

• Chat with Ollama/DeepSeek/ZhipuAI/...
• Chat with Knowledge base(RAG)
• Function calling
• Mcp

workflow

• form
• process
• ticket process
• ...

Voice Of Customer

• feedback
• survey
• ...

Call Center

• Professional call platform based on FreeSwitch
• Supports incoming call pop-up screens, automatic allocation, and call recording
• Data statistics, seamless integration of voice and text services

Video Customer Service

• High-definition video calls based on WebRTC technology
• Supports one-click video conversations and screen sharing
• Suitable for service scenarios requiring intuitive demonstrations

Open Platform

Docker Quick Start

method 1: clone project and start docker compose container，need zhipuai

git clone https://github.com/Bytedesk/bytedesk.git && cd bytedesk/deploy/docker && docker compose -p bytedesk -f docker-compose.yaml up -d

get zhipuai API Key

# zhipuai
# SPRING_AI_ZHIPUAI_BASE_URL: https://open.bigmodel.cn/api/paas
SPRING_AI_ZHIPUAI_API_KEY: 'sk-xxx' // please replace sk-xxx with your zhipuai API key
SPRING_AI_ZHIPUAI_CHAT_ENABLED: "true"
SPRING_AI_ZHIPUAI_CHAT_OPTIONS_MODEL: glm-4-flash
SPRING_AI_ZHIPUAI_CHAT_OPTIONS_TEMPERATURE: 0.7
SPRING_AI_ZHIPUAI_EMBEDDING_ENABLED: "true"
SPRING_AI_ZHIPUAI_EMBEDDING_OPTIONS_MODEL: embedding-2

method 2: run docker compose with ollama

git clone https://github.com/Bytedesk/bytedesk.git && cd bytedesk/deploy/docker && docker compose -p bytedesk -f docker-compose-ollama.yaml up -d

docker ollama pull model

# chat model
docker exec ollama-bytedesk ollama pull qwen3:0.6b
# embedding model
docker exec ollama-bytedesk ollama pull bge-m3:latest
# rerank model
docker exec ollama-bytedesk ollama pull linux6200/bge-reranker-v2-m3:latest
# or download model from huggingface
# docker exec ollama-bytedesk ollama pull hf.co/<username>/<model-repository>

stop container

docker compose -p bytedesk -f docker-compose.yaml stop

change config, otherwise upload image, file and knowledge base cannot be displayed normally

• change docker-compose.yaml file or docker-compose-ollama.yaml

# please replace 127.0.0.1 with your server ip
BYTEDESK_FEATURES_AVATAR_BASE_URL: http://127.0.0.1:9003
BYTEDESK_UPLOAD_URL: http://127.0.0.1:9003
BYTEDESK_KBASE_API_URL: http://127.0.0.1:9003

method 3: run from source code

git clone https://github.com/Bytedesk/bytedesk.git && cd bytedesk && ./mvnw install -Dmaven.test.skip=true && cd starter && ./mvnw spring-boot:run

Preview

local preview

# please replace 127.0.0.1 with your server ip
http://127.0.0.1:9003/
# open port: 9003, 9885
demo username: admin@email.com
demo password: admin

architecture

• architecture

Open Source Client

• desktop
• mobile

Open Source Demo + SDK

Project	Description	Forks	Stars
iOS	iOS
Android	Android
Flutter	Flutter
UniApp	Uniapp
Web	Vue/React/Angular/Next.js/JQuery/...
Wordpress	Wordpress
Woocommerce	woocommerce
Magento	Magento
Prestashop	Prestashop
Shopify	Shopify
Opencart	Opencart
Laravel	Laravel
Django	Django

Links

• Download
• Docs

License

Copyright (c) 2013-2025 微语 Bytedesk.com, All rights reserved.

Licensed under GNU AFFERO GENERAL PUBLIC LICENSE(AGPL v3) (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.gnu.org/licenses/agpl-3.0.html

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Terms of Use

• Prohibited Uses: Strictly prohibited for use in illegal and non-compliant businesses including trojans, viruses, pornography, gambling, fraud, and other illegal activities
• Disclaimer: This software does not guarantee any form of legal liability. Users are responsible for their own usage risks