MaxKB
A self-hosted platform for enterprise knowledge Q&A and agent workflow orchestration.
Per-dimension scores and reasoning
Evidence shows no documentation of permission model, user confirmation, data flow transparency, sensitive data handling, dependency security audit, external effect control, rollback, or source attribution. All criteria scored 0 due to lack of evidence.
Self-consistency: README claims multimodal support but pyproject.toml lacks audio/video libraries, minor inconsistency, scored 1. Dependency availability: dependency list is complete and pinned, but no source or mirror info, scored 1. Failure messages: no error handling or user-facing failure documentation, scored 0.
Audience and scenarios: README clearly lists customer service, knowledge base, research, education, scored 2. Capability boundaries: feature list clear but no limitations, scored 1. Trigger precision: no trigger mechanism or precise instructions, scored 0. Environment fit: Docker quick start and offline install docs, but no system requirements, scored 1.
Information architecture: README structured but lacks detailed docs links, scored 1. Install notes: Docker command and offline install docs, scored 2. Naming stability: project name and version clear, but no naming conventions, scored 1. Examples and FAQ: screenshots but no examples or FAQ, scored 1. Known limitations: not mentioned, scored 0. License: GPL-3.0 license file complete, scored 2. Versioning and changelog: version number but no changelog, scored 1. Maintenance responsibility: author info clear but no maintenance policy, scored 1.
Output usability: screenshots but no output format or integration examples, scored 1. Marginal value: feature-rich but no comparison with alternatives, scored 2. Cost benefit: no performance or resource data, scored 1.
Claim traceability: feature claims not linked to code or docs, scored 1. Cross-source corroboration: Docker image and badges, but no independent verification, scored 1. Fact-inference separation: no distinction between facts and inferences, scored 0.
- Default admin credentials are hardcoded in README, a security risk; users should be prompted to change immediately.
- Dependencies include large libraries like torch, but no resource requirements or performance benchmarks are provided; assess before deployment.
- No permission model or data flow transparency documentation; conduct your own audit before enterprise deployment.
What does this agent do, and when should you use it?
MaxKB, short for Max Knowledge Brain, is an open-source platform for building enterprise-grade agents with a Vue.js frontend, Python/Django backend, LangChain, and PostgreSQL plus pgvector. It brings document upload or online-document crawling, text splitting, vectorization, and RAG-based Q&A into one product. Its workflow engine, function library, and MCP tool-use support the orchestration of more complex AI processes. It supports private models such as DeepSeek, Llama, and Qwen, alongside public models including OpenAI, Claude, Gemini, and MiniMax. It is deployed as a Docker container with a web interface, making it relevant for teams that want to self-host knowledge bases and intelligent Q&A.
MaxKB accepts directly uploaded documents or automatically crawls online documents, then automatically splits and vectorizes text for its RAG Pipeline and intelligent Q&A. Its workflow engine combines a function library with MCP tool-use to orchestrate AI processes. The platform supports text, image, audio, and video input and output, and is described as enabling zero-code integration with third-party business systems. Deployment runs docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb, after which the service is accessed through its web interface.
- An enterprise knowledge-management team uploads internal documents to provide employees with RAG-based knowledge Q&A.
- A customer-service team connects an existing business system to MaxKB to provide an intelligent Q&A entry point.
- A researcher crawls online material and incorporates it into a knowledge-Q&A flow for academic research support.
- An education organization uses a document knowledge base and workflows to organize intelligent Q&A for teaching.
- A team that needs private deployment of DeepSeek, Llama, or Qwen uses one platform to build enterprise agents.
What are this agent's strengths and limitations?
- Combines document upload, online-document crawling, text splitting, vectorization, and RAG Q&A in one platform.
- Provides a workflow engine, function library, and MCP tool-use in addition to knowledge Q&A.
- Explicitly supports both private models and public models including OpenAI, Claude, Gemini, and MiniMax.
- Documents a single Docker startup command, service port, and persistent-volume mount path.
- Default administrator credentials are published in the deployment instructions, so production deployments need their own access-security controls.
- The README does not document provider-specific model configuration, authentication fields, or feature differences between models.
- Its documented stack includes PostgreSQL plus pgvector, but no process is described for migrating existing data to that combination.
- Offline installation is only linked as documentation; the README itself does not provide complete offline-install steps.
How do you install or deploy this agent?
On a server that can run Docker, execute: docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb. After the container starts, open http://your_server_ip:8080. The default administrator username is admin and the password is MaxKB@123... For Docker image pull failures in China, the README points to offline-installation documentation, but does not provide offline installation commands here.
How do you use this agent?
Open http://your_server_ip:8080 and sign in with admin / MaxKB@123... Upload documents or use automatic online-document crawling; MaxKB performs automatic text splitting and vectorization for RAG Q&A. For more involved processes, use the workflow engine with the function library and MCP tool-use. Its stated zero-code third-party-system integration can be used to add Q&A capability to an existing business system.
How does this agent compare with similar options?
MaxKB explicitly supports both private models, such as DeepSeek, Llama, and Qwen, and public models including OpenAI, Claude, Gemini, and MiniMax; the README does not compare it with other agent platforms.
FAQ
What license does MaxKB use?
Which models can it use?
What are the first-login credentials?
admin and password MaxKB@123...What is required for the documented deployment path?
~/.maxkb.