MaxKB README

The project's README from github.com/1Panel-dev/MaxKB. As one markdown file: README.md.

MaxKB

Open-source platform for building enterprise-grade agents

强大易用的企业级智能体平台

1Panel-dev%2FMaxKB | Trendshift

License: GPL v3 Latest release Stars Download
[中文(简体)] | [English]


MaxKB = Max Knowledge Brain, it is an open-source platform for building enterprise-grade agents. MaxKB integrates Retrieval-Augmented Generation (RAG) pipelines, supports robust workflows, and provides advanced MCP tool-use capabilities. MaxKB is widely applied in scenarios such as intelligent customer service, corporate internal knowledge bases, academic research, and education.

Quick start

Execute the script below to start a MaxKB container using Docker:

docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb

Access MaxKB web interface at http://your_server_ip:8080 with default admin credentials:

中国用户如遇到 Docker 镜像 Pull 失败问题,请参照该 离线安装文档 进行安装。

Screenshots

MaxKB Demo1 MaxKB Demo2
MaxKB Demo3 MaxKB Demo4

Technical stack

License

Licensed under The GNU General Public License version 3 (GPLv3) (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/gpl-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.

MaxKB (1Panel-dev/MaxKB)

Searching Database…

23K ·GitHub
What is this?MaxKB (Max Knowledge Brain) is an open-source platform for building enterprise-grade AI agents, combining RAG pipelines, an agentic workflow engine and MCP tool-use. Typical uses: intelligent customer service, internal company knowledge bases, research and education.
Is this a hosted SaaS I sign up for, or something I run myself?You deploy it yourself: MaxKB ships as a Docker container with a Vue.js web interface over a Python/Django backend and a PostgreSQL database. The README mentions no hosted version.
How do I get it running?Run the Docker start script from the README to launch a MaxKB container, then open the web interface and log in with the default admin account (user admin, password MaxKB@123..).
Do I need an OpenAI API key, or can it run on models I host myself?Either. MaxKB is model-agnostic: it supports private models such as DeepSeek, Llama and Qwen as well as public ones like OpenAI, Claude, Gemini and MiniMax, so it can run fully on locally hosted models.
Is the license friendly for use inside a company?It is GPLv3: free to use internally, but if you distribute modified versions of MaxKB itself, those changes must be released under the same license.
How does it turn my documents into answers?Through a RAG pipeline: you upload documents or let it crawl online docs automatically; text is split and vectorized, which reduces model hallucinations and gives a smarter Q&A experience.
What can I build with the workflow engine?Agentic workflows: the engine plus a function library and MCP tool-use let you orchestrate AI processes for complex business scenarios, not just single-shot chat.
Can I embed it into an existing product?Yes — the README stresses zero-coding rapid integration into third-party business systems, quickly adding intelligent Q&A to what you already run.
Is it text-only?No. It natively supports input and output of text, image, audio and video.
Creator
1Panel-dev
Size
84.4 MB
Stars
23K
Age
3y
Commits · 90 Days