MaxKB
面向企业知识问答与工作流编排的自托管智能体构建平台。
- Star 数
- ★ 23k
- 最近更新
- 今天
- License
- GPL-3.0
- 主语言
- Python
- FA 评分
- 24/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 企业知识管理团队将内部文档上传后，为员工提供基于 RAG 的知识问答。
- 不适合
- 希望开箱即用、无需自行配置模型与数据库的团队
- 对默认管理员口令有严格合规要求的生产环境
这个 Agent 能做什么，适合哪些场景？
MaxKB（Max Knowledge Brain）是用于构建企业级智能体的开源平台，采用 Vue.js 前端、Python/Django 后端、LangChain 和 PostgreSQL + pgvector 技术栈。它将文档上传或在线文档自动抓取后的文本切分、向量化与 RAG 问答流程整合在同一产品中。平台还提供工作流引擎、函数库和 MCP 工具调用，用于编排较复杂的 AI 流程。它支持私有模型，例如 DeepSeek、Llama、Qwen，也支持 OpenAI、Claude、Gemini、MiniMax 等公共模型。MaxKB 通过 Docker 容器部署并提供 Web 界面，适合希望自行托管企业知识库与智能问答能力的团队。
用户可直接上传文档，或让 MaxKB 自动抓取在线文档；系统对文本进行自动切分和向量化，并在 RAG Pipeline 中用于智能问答。工作流引擎结合函数库与 MCP tool-use 编排 AI 流程。平台支持文本、图像、音频和视频的输入与输出，并可零代码接入第三方业务系统。部署时运行 docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb，随后通过 Web 界面访问服务。
- 企业知识管理团队将内部文档上传后，为员工提供基于 RAG 的知识问答。
- 客服团队把已有业务系统接入 MaxKB，为用户提供智能问答入口。
- 研究人员抓取在线资料并将其纳入知识问答流程，用于学术研究辅助。
- 教育机构使用文档知识库和工作流，为教学场景组织智能问答流程。
- 需要私有部署 DeepSeek、Llama 或 Qwen 模型的团队，用同一平台构建企业智能体。
如何安装或部署这个 Agent？
在可运行 Docker 的服务器执行：docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb。容器启动后访问 http://your_server_ip:8080。默认管理员账号为 admin，密码为 MaxKB@123..。README 对中国用户的 Docker 镜像拉取失败情况指向离线安装文档，但未在此处给出离线安装命令。
如何使用这个 Agent？
打开 http://your_server_ip:8080，使用 admin / MaxKB@123.. 登录。上传文档或使用在线文档自动抓取功能，系统会执行自动文本切分与向量化，并用于 RAG 问答。需要复杂流程时，在工作流引擎中组合函数库和 MCP tool-use；如需嵌入业务系统，可使用其零代码第三方系统集成能力。
这个 Agent 有哪些优点和局限？
- 将文档上传、在线文档抓取、文本切分、向量化和 RAG 问答纳入同一平台。
- 同时提供工作流引擎、函数库与 MCP tool-use，覆盖知识问答之外的流程编排。
- 明确支持私有模型与 OpenAI、Claude、Gemini、MiniMax 等公共模型。
- Docker 单容器启动命令、端口和持久化挂载路径均已给出。
- 默认管理员凭据公开写在部署说明中，实际部署需要自行管理访问安全。
- README 未说明模型提供商的具体配置方式、认证字段或各模型功能差异。
- 技术栈依赖 PostgreSQL + pgvector；将既有数据迁移到该组合的流程没有说明。
- 离线安装仅给出文档指引，README 本身未提供完整离线安装步骤。
这个 Agent 与同类方案有什么区别？
MaxKB 明确同时支持私有模型（如 DeepSeek、Llama、Qwen）和公共模型（如 OpenAI、Claude、Gemini、MiniMax）；README 未提供与其他智能体平台的功能对比。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| MaxKB 当前 | 24 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 23k | 今天 | Python | OpenAI API · Claude API |
| 《LangGraph 1.0 完全指南》 | 69 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 469 | 1 个月前 | Jupyter Notebook | Claude Code |
| AI Agent 工程学习手册 | 55 · 缺口较多 | 开发框架免费 | ★ 651 | 13 天前 | HTML | — |
| CUGA | 51 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.1k | 3 天前 | Python | OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示仓库未提供权限模型、用户确认机制、数据流透明性、敏感数据处理、依赖安全审计、外部影响控制、回滚机制或来源归属的说明。所有标准均因缺乏证据而评为0。
自一致性：README声称支持多模态和多种模型，但pyproject.toml中未包含音频/视频处理库，存在轻微不一致，评为1。依赖可用性：依赖列表完整且版本固定，但未提供依赖来源或镜像信息，评为1。失败消息：未提供错误处理或用户可见的失败消息文档，评为0。
受众与场景：README明确列出智能客服、知识库、学术研究等场景，评为2。能力边界：功能列表清晰但未说明限制，评为1。触发精度：未提供触发机制或精确指令，评为0。环境适配：提供Docker快速启动和离线安装文档，但未说明系统要求，评为1。
信息架构：README结构清晰但缺少详细文档链接，评为1。安装说明：提供Docker命令和离线安装文档，评为2。命名稳定性：项目名称和版本号明确，但未说明命名规范，评为1。示例与FAQ：有截图但无示例或FAQ，评为1。已知限制：未提及，评为0。许可证：GPL-3.0许可证文件完整，评为2。版本与变更日志：有版本号但无变更日志，评为1。维护责任：作者信息明确但未说明维护政策，评为1。
输出可用性：有截图但未提供输出格式或集成示例，评为1。边际价值：功能丰富，但未与其他平台对比，评为2。成本效益：未提供性能或资源消耗数据，评为1。
声明可追溯性：README中的功能声明未链接到代码或文档，评为1。跨来源佐证：有Docker镜像和GitHub badges，但未提供独立验证，评为1。事实与推断分离：未区分事实与推断，评为0。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 默认管理员密码硬编码在README中，存在安全风险，应提示用户立即修改。
- 依赖中包含torch等大型库，但未提供资源需求或性能基准，部署前需评估。
- 未提供权限模型或数据流透明性文档，企业部署前需自行审计。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Security Fixes ■ Security (X-Pack): Fixed a vulnerability where the login authentication configuration endpoint did not redact sensitive fields, exposing third-party login app credentials (such as DingTalk app_key, corp_id, and app_secret) in plaintext, which could lead to enterprise app takeover. Bug Fixes ■ Knowledge Base: Fixed an issue where special characters such as \, /, :, *, and ? could be entered when quickly creating a blank document. …在 GitHub 查看 ↗ -
发布说明摘录
Enhancements - Knowledge Base: Special characters such as \, /, ?, *, and [] are now disallowed when renaming documents. - Agent: A confirmation prompt is now shown when deleting conversation history, to prevent accidental deletion. - Q&A Page: Tables in AI responses now support horizontal scrolling when the number of columns exceeds the visible width. Bug Fixes - Agent: Fixed an issue where content wrapped in html_render tags was rendered blank when exported to PDF or image (#7222). …在 GitHub 查看 ↗ -
发布说明摘录
Security Vulnerability Fixes - Security: Fixed a security vulnerability where Chat file uploads could spoof APPLICATION attribution and be read anonymously, allowing content injection into the application namespace. - Security: Fixed a security vulnerability where document/paragraph migration only validated source knowledge base permissions, leading to cross-tenant content injection and RAG poisoning. …在 GitHub 查看 ↗
常见问题
MaxKB 采用什么许可证？
可以使用哪些模型？
首次登录信息是什么？
admin，默认密码为 MaxKB@123..。需要哪些部署条件？
~/.maxkb。