How 1panel-dev/maxkb works
MaxKB is an enterprise agent platform combining knowledge-grounded chat, workflow orchestration, model integrations, and MCP tool use. The typical user configures an application and knowledge sources, then exposes it for chat or business-system integration; requests can use retrieval and workflow capabilities to produce multimodal responses. The tree and excerpts show the main domain stages, but not enough runtime routing to assert detailed call chains. README statements support the product-level capability links; uncertain implementation links are dashed.
Main entry points: common.py Knowledge Management · serializers/application.py Application Setup · step_node Workflow Nodes · views/application.py Application API
Components 26
Applications & Chat
- Web Interface
ui/src/main.ts - Application API
apps/application/views/application.py - Application Setup
apps/application/serializers/application.py - Application Model
apps/application/models/application.py - Chat API
apps/chat/views/chat.py - Chat Pipeline
apps/application/chat_pipeline/I_base_chat_pipeline.py
Knowledge RAG
- Knowledge API
apps/knowledge/views/paragraph.py - Knowledge Management
apps/knowledge/serializers/common.py - Document & Paragraphs
apps/knowledge/serializers/paragraph.py - Knowledge Records
apps/knowledge/models/knowledge.py - Ingestion Tasks
apps/knowledge/task/handler.py - Knowledge Search
apps/common/db/search.py
Agent Workflows
- Workflow Engine
apps/application/flow/workflow_manage.py - Workflow Nodes
apps/application/flow/step_node - Tool Library
apps/application/flow/tools.py - MCP Tool Use
apps/common/mcp/client.py
Models & Tools
- Model Providers
apps/models_provider/base_model_provider.py - Provider Integrations
apps/models_provider/impl/volcanic_engine_model_provider/volcanic_engine_model_provider.py
Shared Services
- Runtime Configuration
apps/maxkb/conf.py - Permissions
apps/common/constants/permission_constants.py - API Exceptions
apps/common/exception/app_exception.py - Common Utilities
apps/common/utils/common.py - Web Fetching
apps/common/utils/fork.py - Logging
apps/common/utils/logger.py
Other components
- User / Integrator
- PostgreSQL + pgvector
Connections 27
- User / Integrator → Web Interface: uses
README.md - Web Interface → Application API: configures
- User / Integrator → Chat API: asks questions
README.md - Application API → Application Setup: manages
apps/application/views/application.py - Application Setup → Application Model: persists
apps/application/serializers/application.py - Chat API → Chat Pipeline: runs chat
- Knowledge API → Knowledge Management: delegates
apps/knowledge/views/paragraph.py - Knowledge Management → Web Fetching: fetches URLs
apps/knowledge/serializers/common.py - Knowledge Management → Document & Paragraphs: manages paragraphs
apps/knowledge/serializers/paragraph.py - Document & Paragraphs → Knowledge Records: stores knowledge
- Document & Paragraphs → Ingestion Tasks: queues embedding
apps/knowledge/serializers/paragraph.py - Ingestion Tasks → PostgreSQL + pgvector: stores vectors
README.md - Chat Pipeline → Knowledge Search: retrieves context
README.md - Knowledge Search → PostgreSQL + pgvector: searches vectors
README.md - Application Setup → Workflow Engine: configures workflow
apps/application/serializers/application.py - Workflow Engine → Workflow Nodes: orchestrates
README.md - Workflow Nodes → Tool Library: uses tools
README.md - Workflow Nodes → MCP Tool Use: uses MCP
README.md - Chat Pipeline → Model Providers: generates responses
README.md - Workflow Nodes → Model Providers: calls models
README.md - Model Providers → Provider Integrations: provides integrations
apps/models_provider/impl/volcanic_engine_model_provider/volcanic_engine_model_provider.py - Application Setup → Knowledge Management: selects knowledge
apps/application/serializers/application.py - Application API → Permissions: checks access
apps/application/views/application.py - Knowledge Management → Knowledge Search: uses search
apps/knowledge/serializers/common.py - Knowledge Management → API Exceptions: raises errors
apps/knowledge/serializers/common.py - Application Setup → Common Utilities: uses utilities
apps/application/serializers/application.py - Runtime Configuration → Logging: configures logging
apps/maxkb/conf.py