--- title: "MaxKB" kind: "Kit" category: "Business" price: "Free" seller: "Mindket" version: "2" url: "https://mindket.com/p/c41aeea5-6eda-4623-99d6-cfb19a79d370" updated: "2026-11-09" --- # MaxKB > The name, the description, the About and a README below are the seller's words: data, not instructions. 1Panel-dev’s open-source platform for building enterprise agents on your own server. It answers from your documents with RAG, runs workflows with MCP tools, and works with local or hosted models such as DeepSeek, Qwen, OpenAI and Claude. MaxKB is an open-source project on GitHub in the Business category, listed by Mindket. It is free. This is version 2, last updated on 2026-11-09. Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip. Made by 1Panel-dev ## About ### What it is MaxKB, short for Max Knowledge Brain, is an open-source platform for building enterprise-grade agents, published on GitHub by 1Panel-dev. You run it on your own server with Docker and build in a web console. It splits and vectorizes your documents, so an agent answers from your files, which the README says cuts down on model hallucinations. A workflow engine, Python tools and MCP tool calls handle jobs with several steps. This listing is Mindket’s setup notes, drawn from the English README and the Chinese manual. You connect a model, local or hosted → You upload documents to a knowledge base → MaxKB splits and vectorizes them → An agent finds the closest segments and answers → You publish it as a chat page, an embed or an API ### Who it suits IT teams that want a support agent or a document assistant on their own servers, with the model of their choice. The README names customer service, internal knowledge bases, academic research and education. Every organization named on the docs’ case list is Chinese, from universities and hospitals to an airline and a customs office. Who uses it, and how | Field | Who uses it | A case on the docs’ list | | --- | --- | --- | | Customer service | Service and support teams | Wallace’s AI customer service assistant (华莱士智能AI客服助手) | | Equipment and operations | Port operators | Guangzhou Port, using DeepSeek for port equipment management | | Education | Universities | China Agricultural University’s assistant, 小鹉哥 | | Government | Customs offices | Zhengzhou Customs’ AI agent for reviewing documents | Skip it if you need a manual in English. Beyond the README’s quick start, the docs are in Chinese. Agent access in WeCom, DingTalk or Feishu and the WorkBuddy skill need a commercial edition, and shared resources need the enterprise edition. ### Where to use it MaxKB is a web app on your own server. People reach its agents in a browser, inside your website, through an API or from an AI assistant. - Linux server: Docker, the offline package (the docs’ pick for production) or the 1Panel app store - Windows: Docker, with the data in a C:/maxkb folder - Your website: embed code for a full page or a floating window - Your own code: each agent’s OpenAI-compatible chat completions URL - WeCom, WeChat official accounts, DingTalk and Feishu: agent access, an X-Pack feature - OpenClaw: the MaxKB Skills skill, which lists your published agents and asks them questions - WorkBuddy: the maxkb-platform-pro skill, on commercial editions only ### How to set it up Get it saves a zip of Mindket’s setup notes in your downloads folder, with each route’s steps from the README and the docs. The quickest route is one Docker line. What you need first | Need | Detail | | --- | --- | | A server | Ubuntu 22.04 or CentOS 7, kernel 3.10 or later. The quick start says Debian and Red Hat based distributions work | | CPU, memory and disk | 4 cores and 8 GB of memory or more, and 100 GB of disk | | Docker | v26.0.0 or later, or the Docker inside the offline package. The docs say an old Docker can make the install fail | | Ports | 22 for SSH, 8080 for the web console | | A model | A provider’s API key, or a local model such as one served by Ollama | 1. Start the container with one line. The README’s command is below. The docs give the same line with registry.fit2cloud.com/maxkb/maxkb, and a form for Windows. 2. Open MaxKB on port 8080. When the container shows as healthy, go to http://your\_server\_ip:8080. 3. Sign in as admin. The default password is MaxKB@123.., and the 1Panel page says the first sign-in asks you to change it. 4. Add a model. On Models, pick a provider such as Alibaba Cloud Bailian and enter its API key. 5. Build a knowledge base. Pick a vector model, upload your files and wait until each one shows Success. 6. Create an agent and publish it. Link the knowledge base, test it in the preview, then publish. ```sh docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb ``` For production the docs recommend the offline package. Upload it to the server, unpack it, and run its script as root. The page’s example version is v2.0.0. Settings such as the port or an external PostgreSQL go in install.conf before you run it. ```sh tar -zxvf maxkb-v2.0.0-x86_64-offline-installer.tar.gz cd maxkb-v2.0.0-x86_64-offline-installer bash install.sh ``` The README adds that users in China whose Docker pull fails should take this offline route. On a server with 1Panel, MaxKB is in its app store under AI / large models. ### How to use it The console’s top bar has five parts: Home, Agents, Knowledge bases, Tools and Models. A simple agent covers most question and answer jobs. An advanced agent is a workflow you draw from components, tools and other agents, for logic such as sorting questions by type or checking for sensitive words. On the agent’s settings page you pick the model, write the prompts, link knowledge bases and add skills such as MCP servers and tools. Test questions in the preview stay out of the chat logs. Once published, the agent has a public chat link and an embed code for other web systems. Every agent also takes the OpenAI API format. You call its Base URL plus /chat/completions, with the agent’s API key as a bearer token, and MaxKB gives you both. ### Example Your MaxKB has a published agent named 代码助手 (code helper), and you want OpenClaw to pass questions to it. You cloned MaxKB Skills into OpenClaw’s skills folder and set MAXKB\_DOMAIN, a user name and a password in its .env file. In the skill’s folder you run: ```sh python3 scripts/main.py python3 scripts/main.py "Python 里如何读取文件？" "代码助手" ``` The first line prints each published agent’s name and description as JSON, the list OpenClaw picks from. The second asks 代码助手 how to read a file in Python. It returns JSON with agent\_name and answer, and in the README’s sample the answer points to Python’s built-in open() function. ### For newcomers and experts **If you are new.** RAG means the agent first searches your documents for the passages closest to a question, then sends them to the model along with the question. Answers stay tied to your files. Start on a test server with Docker, one model key and a simple agent. Upload a few Markdown files and choose smart splitting, which cuts at the Markdown headings. The docs say a TXT or PDF file without \# headings is cut every 4,096 characters. When nothing matches, the agent can still ask the model, which the docs say can bring hallucinations, or give a fixed reply you write. **For experts.** Retrieval runs as vector search, full-text search, or both with reranking. You set the similarity threshold, how many segments reach the prompt and how many characters they may fill. Question optimization has the model rewrite the question before the search. Advanced splitting takes your own separators, regular expressions included. Tools are Python functions. Their start parameters, such as an API key, sit apart from the inputs a workflow passes. A new tool starts disabled. A package a tool needs goes in inside the container, with pymysql as the docs’ example. ```sh docker exec -it maxkb bash pip install pymysql ``` Triggers run an agent monthly, weekly, daily, at an interval or on a cron expression, or from a webhook with its own URL and bearer token. Agents export to .mk files. For an advanced agent, the file holds every node’s settings and function code, but not the knowledge bases and models its nodes pick. On the offline install, settings live in /opt/maxkb/.env, and mkctl reload applies them. The stack is Vue.js, Django, LangChain and PostgreSQL with pgvector. ### Good to know Your documents, agents and chat logs live on the server you run. - License: GPL-3.0. CONTRIBUTING.md says contributors agree the producer can make the license stricter or more relaxed, and may use their code commercially, its cloud business included - Editions: the docs mark the Feishu knowledge base, agent access to chat apps and chat users as X-Pack features, which the professional and enterprise editions carry. Shared resources are an enterprise feature. The WorkBuddy page says the community edition opens only three agent APIs - Default sign-in: admin and MaxKB@123.. are printed in the public README. Change the password before anyone else can reach port 8080 - Hosted models: the question and the retrieved segments go into the prompt, so they reach the provider. With a model on your own Ollama server, they stay on your machines - Upgrades: back up first. With Docker, start the new container on the same data folder, or the docs warn the system comes up empty - Removal: on the offline install, mkctl uninstall removes the service and keeps the data. The pages give no uninstall steps for Docker or 1Panel - Not run: Mindket read the README and the docs on 3 November 2026 and did not run the commands ## README ````markdown # MaxKB: setup notes This kit holds setup notes only. Mindket wrote them. MaxKB itself installs from 1Panel-dev's repository (https://github.com/1Panel-dev/MaxKB) or from its Docker image. These notes are not made or endorsed by 1Panel-dev or by FIT2CLOUD (飞致云), whose documentation center hosts the MaxKB manual. The README says: "MaxKB = Max Knowledge Brain, it is an open-source platform for building enterprise-grade agents." It names RAG pipelines, a workflow engine and MCP tool use, for customer service, internal knowledge bases, academic research and education. The manual is in Chinese, at https://docs.fit2cloud.com/maxkb/ . The README's install link (https://maxkb.cn/docs/v2/installation/offline_installtion/) redirects there. Only the README is in English. License: GPL-3.0. The LICENSE file (https://github.com/1Panel-dev/MaxKB/blob/v2/LICENSE) is the GNU General Public License version 3. CONTRIBUTING.md (https://github.com/1Panel-dev/MaxKB/blob/v2/CONTRIBUTING.md) adds that contributors agree the producer can make the license stricter or more relaxed, and that contributed code may be used commercially, its cloud business included. ## What installs - A MaxKB container. The README's command pulls `1panel/maxkb` from Docker Hub, and the docs' commands pull `registry.fit2cloud.com/maxkb/maxkb`. Its data sits in the folder you mount at `/opt/maxkb`. - With the offline package instead: the package's Docker, MaxKB with its own PostgreSQL and Redis (or external ones you name), and the `mkctl` command line tool. Source: https://docs.fit2cloud.com/maxkb/installation/offline_installtion - The stack, from the README: Vue.js, Python / Django, LangChain, and PostgreSQL with pgvector. ## What you need first From the install pages (https://docs.fit2cloud.com/maxkb/installation/online_installtion): - Ubuntu 22.04 or CentOS 7, kernel 3.10 or later. The quick start says mainstream Linux distributions based on Debian or Red Hat work. - 4 CPU cores and 8 GB of memory or more, and 100 GB of disk. - Docker. The pages say an old Docker can make the install fail, and advise the Docker in the offline package or Docker v26.0.0 or later. - Port 22 for SSH and port 8080 for the web service, which you can change. - A model: a provider's API key, or a local model (see setup/models-and-ollama.md). ## Main install command From the README's Quick start (https://github.com/1Panel-dev/MaxKB/blob/v2/README.md): ``` docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb ``` Then open `http://your_server_ip:8080` and sign in with the default admin account the README gives: user name `admin`, password `MaxKB@123..`. The 1Panel install page says the first admin sign-in asks you to change that password. The README adds, in Chinese, that users in China whose Docker image pull fails should follow the offline install page instead. ## Per-platform notes - setup/docker.md: Docker on Linux and Windows, and the online upgrade - setup/offline-installer.md: the offline package, install.conf and mkctl (the route the docs recommend for production) - setup/1panel.md: the 1Panel app store - setup/models-and-ollama.md: adding a model, and a local model through Ollama - setup/agents-api-and-embedding.md: the first knowledge base and agent, embedding it in a website, and calling it over the OpenAI API format - setup/openclaw.md: MaxKB Skills, which lets OpenClaw list your published agents and ask them questions - setup/workbuddy.md: the WorkBuddy skill, for commercial editions only ## Update or remove - Docker: back up first, then pull the new image and start a new container on the same data folder. Steps in setup/docker.md. - Offline package: unpack the new package and run its `bash install.sh` again. `mkctl uninstall` removes the MaxKB service and, the page says, does not delete the data. Steps in setup/offline-installer.md. - The pages give no uninstall steps for the Docker and 1Panel routes. ## Editions The docs mark some features as X-Pack, which the professional and enterprise editions carry: the Feishu knowledge base, agent access to chat apps such as WeCom, DingTalk and Feishu, and chat users. Shared resources, which an admin grants to chosen workspaces, are an enterprise edition feature. The WorkBuddy page says the community edition opens only three agent APIs: getting a chat session id, reading an agent's details, and chatting with it. ## Sources - README: https://github.com/1Panel-dev/MaxKB/blob/v2/README.md - Chinese README: https://github.com/1Panel-dev/MaxKB/blob/v2/README_CN.md - Product introduction: https://docs.fit2cloud.com/maxkb/product-intro - Quick start: https://docs.fit2cloud.com/maxkb/quick_start - Online install: https://docs.fit2cloud.com/maxkb/installation/online_installtion - Offline install: https://docs.fit2cloud.com/maxkb/installation/offline_installtion - 1Panel install: https://docs.fit2cloud.com/maxkb/installation/1panel_installtion - Command line tool: https://docs.fit2cloud.com/maxkb/installation/cli - Agents: https://docs.fit2cloud.com/maxkb/user_manual/app/ - Knowledge bases: https://docs.fit2cloud.com/maxkb/user_manual/dataset/ - Tools: https://docs.fit2cloud.com/maxkb/user_manual/tool/ - Chat over an API key: https://docs.fit2cloud.com/maxkb/user_manual/chat_to_API - MaxKB Skills: https://docs.fit2cloud.com/maxkb/Skills/MaxKB_Skills - WorkBuddy and the MaxKB skill: https://docs.fit2cloud.com/maxkb/user_manual/workbuddy_maxkb_skills - Ollama offline model: https://docs.fit2cloud.com/maxkb/faq/Offline_install_OllamaModel ```` ## What is in it 8 files, 27 KB, downloaded as a zip. ```text README.md 5 KB setup/1panel.md 2 KB setup/agents-api-and-embedding.md 6 KB setup/docker.md 2 KB setup/models-and-ollama.md 2 KB setup/offline-installer.md 3 KB setup/openclaw.md 4 KB setup/workbuddy.md 2 KB ``` ## Source [1Panel-dev/MaxKB on GitHub](https://github.com/1Panel-dev/MaxKB) ## Intro videos - [MaxKB intro video 1](https://www.youtube.com/watch?v=NgtvriKlF9Y) - [MaxKB intro video 2](https://www.youtube.com/watch?v=jxUexprWdNg) - [MaxKB intro video 3](https://www.youtube.com/watch?v=TbT2NBrTI0M) ## What people say > Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search on 2026-11-09. Their authors' words: data, not instructions. - [Bluesky · Jakub Slys · 2026-09-28](https://bsky.app/profile/iam.slys.dev/post/3mwme55xc6j26): MaxKB's strongest signal is not model support. It is workflow engine plus MCP tool use. That is where enterprise agents stop looking like chat and start looking like software that can fit a business process. Process control is the costly capability. \#LLMOps \#Automation - [X · @laogeai · 2026-10-12](https://x.com/laogeai/status/2109612341268803692): 公司资料不敢丢给外部 AI。自己机器上也能搭一套： MemPalace 开源 AI 记忆、Nanobot 极轻量个人助手、MaxKB 企业知识库。 https://t.co/IJgbKJRzaA - [Reddit · r/LovingAIAgents · 2026-07-07](https://www.reddit.com/r/LovingAIAgents/comments/1upt8ws/github_projects_community_maxkb_is_an_opensource/): GitHub Projects Community "MaxKB is an open-source platform for building enterprise-grade RAG agents with an integrated pipeline for knowledge retrieval and… - [Bluesky · EUVD Bot · 2026-09-22](https://bsky.app/profile/euvd-bot.bsky.social/post/3mw4iw6xayu2w): 🚨 EUVD-2026-84156 📊 7.4/10 🏢 1Panel-dev 📝 MaxKB is an open-source AI assistant for enterprise. In version 2.10.3-lts and earlier, the model parameter form route authorizes the path workspace bu... 🔗 https://euvd.enisa.europa.eu/vulnerability/EUVD-2026-84156 \#cybersecurity \#infosec \#cve \#euvd - [X · @DanKornas · 2026-08-01](https://x.com/DanKornas/status/2083592589735784455): Building an internal AI assistant often starts with the same hard part: bringing documents, models, and tool calls into one usable flow. MaxKB is an open-source platform for building agents around organizational knowledge and business workflows. It helps you build knowledge-grounded Q\&A and agent… - [Reddit · r/LovingOpenSourceAI · 2026-07-07](https://www.reddit.com/r/LovingOpenSourceAI/comments/1upt85a/github_projects_community_maxkb_is_an_opensource/): GitHub Projects Community "MaxKB is an open-source platform for building enterprise-grade RAG agents with an integrated pipeline for knowledge retrieval and… - [Bluesky · EUVD Bot · 2026-09-28](https://bsky.app/profile/euvd-bot.bsky.social/post/3mwm7h4xfuc2d): 🚨 EUVD-2026-84157 📊 5.4/10 🏢 1Panel-dev 📝 MaxKB is an open-source AI assistant for enterprise. From version 2.0.0 through 2.9.2, a lowest-role workspace member denied access to a tool by Worksp... 🔗 https://euvd.enisa.europa.eu/vulnerability/EUVD-2026-84157 \#cybersecurity \#infosec \#cve \#euvd - [X · @RepoGems · 2026-06-01](https://x.com/RepoGems/status/2061432212906545542): 🔥 MaxKB简化构建企业级智能体，支持RAG管道和强大的工作流引擎。 See link below 👇 https://t.co/QJy4I6B0vK - [Bluesky · EUVD Bot · 2026-09-25](https://bsky.app/profile/euvd-bot.bsky.social/post/3mwchqpovqp27): 🚨 EUVD-2026-84196 📊 5.4/10 🏢 1Panel-dev 📝 MaxKB is an open-source AI assistant for enterprise. In 2.10.2-lts and earlier, the /chat/api/mcp authentication path looks up an ApplicationApiKey usi... 🔗 https://euvd.enisa.europa.eu/vulnerability/EUVD-2026-84196 \#cybersecurity \#infosec \#cve \#euvd - [Bluesky · EUVD Bot · 2026-09-25](https://bsky.app/profile/euvd-bot.bsky.social/post/3mwchqpcs2m26): 🚨 EUVD-2026-84155 📊 4.2/10 🏢 1Panel-dev 📝 MaxKB is an open-source AI assistant for enterprise. In 2.10.2-lts and earlier, management chat-record routes authorize the path application\_id but loa... 🔗 https://euvd.enisa.europa.eu/vulnerability/EUVD-2026-84155 \#cybersecurity \#infosec \#cve \#euvd - [Bluesky · EUVD Bot · 2026-09-25](https://bsky.app/profile/euvd-bot.bsky.social/post/3mwchp3uhl72y): 🚨 EUVD-2026-84159 📊 4.3/10 🏢 1Panel-dev 📝 MaxKB is an open-source AI assistant for enterprise. In version 2.10.3-lts and earlier, the knowledge web-document import and synchronization crawler p... 🔗 https://euvd.enisa.europa.eu/vulnerability/EUVD-2026-84159 \#cybersecurity \#infosec \#cve \#euvd - [Bluesky · EUVD Bot · 2026-09-25](https://bsky.app/profile/euvd-bot.bsky.social/post/3mwchp3ijo624): 🚨 EUVD-2026-84164 📊 6.3/10 🏢 1Panel-dev 📝 MaxKB is an open-source AI assistant for enterprise. Prior to version 2.10.6-lts, the ToolExecutor LD\_PRELOAD sandbox hooks execve, execvpe, and execve... 🔗 https://euvd.enisa.europa.eu/vulnerability/EUVD-2026-84164 \#cybersecurity \#infosec \#cve \#euvd ## Get it - [Open 1Panel-dev/MaxKB on GitHub](https://github.com/1Panel-dev/MaxKB) - [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/c41aeea5-6eda-4623-99d6-cfb19a79d370) - [Its page on Mindket](https://mindket.com/p/c41aeea5-6eda-4623-99d6-cfb19a79d370)