<a href="https://openkf.github.io/website" target="_blank"> <img src="assets/logo-gif/openkf-logo.gif" width="60%" height="30%"/> </a> <h3 align="center" style="border-bottom: none"> ⭐️ OpenKF(Open Knowledge Flow) is an online intelligent customer service system. ⭐️ <h3> <a href="https://goreportcard.com/report/github.com/openimsdk/openkf/server"><img src="https://goreportcard.com/badge/github.com/openimsdk/openkf/server" alt="A+"></a> <a href="https://github.com/openimsdk/openkf/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22good+first+issue%22"><img src="https://img.shields.io/github/issues/OpenIMSDK/OpenKF/good%20first%20issue?logo=%22github%22" alt="good first"></a> <a href="https://github.com/openimsdk/openkf"><img src="https://img.shields.io/github/stars/OpenIMSDK/OpenKF.svg?style=flat&logo=github&colorB=deeppink&label=stars"></a> <a href="https://join.slack.com/t/openimsdk/shared_invite/zt-22720d66b-o_FvKxMTGXtcnnnHiMqe9Q"><img src="https://img.shields.io/badge/Slack-500%2B-blueviolet?logo=slack&logoColor=white"></a> <a href="https://github.com/openimsdk/openkf/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-green"></a> <a href="https://golang.org/"><img src="https://img.shields.io/badge/Language-Go-blue.svg"></a> <a href="./README.md">English</a> • <a href="./README_zh-CN.md">中文</a>

🧩 Awesome features

OpenKF is an opensource customer service system based on OpenIM.
Support LLM(Local Knowledgebase) customer service.
Support multi-channel customer service, and easy to integrate with third-party systems.
Easy to deploy and secondary development.

📺 System Preview

<details open> <summary>Login Page</summary> <img src="assets/images/login_page.png" /> </details> <details> <summary>Config Page</summary> <img src="assets/images/config_page.png" /> </details> <details> <summary>Dashboard Page</summary> <img src="assets/images/dashboard_page.png" /> </details> <details> <summary>Platform Page</summary> <img src="assets/images/platform_page.png" /> </details> <details> <summary>Session Page</summary> <img src="assets/images/session_page.png" /> </details>

🛫 Quick start

Note: You can get started quickly with OpenKF.

📦 Installation

git clone https://github.com/openimsdk/openkf openkf && export openkf=$(pwd)/openkf && cd $openkf && make

🚀 Run

Note: We need to run the backend server first

make build

open another terminal run the following command

# make dev
cd web
npm run dev

📖 Contributors get up to speed

Be good at using Makefile, it can ensure the quality of your project.

Usage: make <TARGETS> ...

Targets:
  all                          Build all the necessary targets. 🏗️
  build                        Build binaries by default. 🛠️
  go.build                     Build the binary file of the specified platform. 👨‍💻
  build-multiarch              Build binaries for multiple platforms. 🌍
  tidy                         tidy go.mod 📦
  style                        Code style -> fmt,vet,lint 🎨
  fmt                          Run go fmt against code. ✨
  vet                          Run go vet against code. 🔍
  generate                     Run go generate against code and docs. ✅
  lint                         Run go lint against code. 🔎
  test                         Run unit test ✔️
  cover                        Run unit test with coverage. 🧪
  docker-build                 Build docker image with the manager. 🐳
  docker-push                  Push docker image with the manager. 🔝
  docker-buildx-push           Push docker image with the manager using buildx. 🚢
  copyright-verify             Validate boilerplate headers for assign files. 📄
  copyright-add                Add the boilerplate headers for all files. 📝
  swagger                      Generate swagger document. 📚
  serve-swagger                Serve swagger spec and docs. 🌐
  clean                        Clean all builds. 🧹
  help                         Show this help info. ℹ️

Note: It's highly recommended that you run make all before committing your code. 🚀

make all

🕋 Architecture diagram

Architecture

MVC Architecture Design:

MVC

🤖 File Directory Description

Catalog standardization design structure:

.
├── assets
│   └── images
├── build
├── deploy
├── docs
├── kf_plugins # Local knowledgebase with LLM
│   ├── chat
│   ├── config
│   ├── data
│   ├── logs
│   ├── model
│   └── utils
├── scripts
│   ├── githooks
│   └── LICENSE
├── server # OpenKF backend
│   ├── cmd
│   ├── data
│   ├── docs
│   ├── examples
│   ├── internal
│   ├── logs
│   ├── pkg
│   ├── test
│   └── tools
└── web # OpenKF frontend
    ├── public
    ├── scripts
    └── src

🗓️ community meeting

We want anyone to get involved in our community, we offer gifts and rewards, and we welcome you to join us every Thursday night.

Our conference is in the OpenIM Slack 🎯 openkf pipeline, then you can search the openkf pipeline to join

We take notes of each biweekly meeting in GitHub discussions, and our minutes are written in Google Docs.

🤼‍ Contributing & Development

OpenIMSDK Our goal is to build a top-level open source community. We have a set of standards, in the Community repository.

If you'd like to contribute to this OpenKF repository, please read our contributor documentation.

Before you start, please make sure your changes are in demand. The best for that is to create a new discussion OR Slack Communication, or if you find an issue, report it first.

📱 Join Our WeChat Developer Group 🛠️

Add as a friend and include the note <code>openkf</code> to receive an invitation to our ' openkf ' developers' group chat. <img src="http://sm.nsddd.top/0d6775b78a7bd57e0d8b45cd695bf0df.png" alt="WeChat Group" style="max-width:30%;height:auto;">

🚨 License

OpenKF is licensed under the Apache 2.0 license. See LICENSE for the full license text.

The OpenKF logo, including its variations and animated versions, displayed in this repository OpenKF under the assets/logo and assets/logo-gif directories, are protected by copyright laws.

🔮 Thanks to our contributors!

Openkf

Install / Use

README