• 从 GitHub 上下载对应的源码

• 安装anaconda创建虚拟环境

使用Anaconda新建MaxKB专属的虚拟环境，网址：Download Success | Anaconda 下载 ANACONDA ；

从开始菜单找到并打开 “Anaconda Prompt”（这是 Anaconda 自带的终端，已自动配置好环境变量）；

conda create --name maxkb python==3.11.9

用 pycharm 打开项目设置环境；

选择对应的版本

• 安装依赖

安装前端依赖

切换到 maxkb 的虚拟环境（在Pycharm 自带的 Terminal 新建一个cmd；

cd .\ui\ 
npm install

安装后端依赖

回到 MaxKB 目录下，使用conda或者pip安装poetry包管理器；

conda install poetry
pip install django
pip install python-dotenv
pip install pyyaml
pip install redis
pip install djangorestframework
pip install drf-spectacular
pip install drf-spectacular-sidecar
pip install django-celery-beat
pip install django-apscheduler
pip install uuid-utils
pip install pydub
pip install django-mptt
pip install psycopg2-binary
pip install langchain
pip install pycryptodome
pip install django-redis
pip install langchain-mcp-adapters
pip install jieba
pip install langchain-community
pip install langchain-openai
pip install dashscope
pip install langchain_anthropic
pip install botocore
pip install langchain-google-genai
pip install langchain-huggingface
pip install transformers
pip install scikit-learn
pip install langchain-ollama
pip install tencentcloud-sdk-python
pip install websockets
pip install volcengine-python-sdk
pip install xinference-client
pip install pylint
pip install zhipuai
pip install celery_once
pip install html2text
pip install openpyxl
pip install xlwt
pip install xlrd
pip install python-docx
pip install PyMuPDF
pip install langgraph
pip install captcha
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

• Window 目录准备和数据库准备

创建对应的文件夹和配置文件；

postgresql 数据库 和 redis 数据库需要自行安装，使用dorker 容器快速启动即可；

# 数据库配置
DB_NAME: maxkb_desktop
DB_HOST: 192.168.xx.xxx
DB_PORT: 5236
DB_USER: postgres
DB_PASSWORD: password
DB_ENGINE: django.db.backends.postgresql_psycopg2

# redis 配置
REDIS_HOST: 192.168.xx.xxx
REDIS_PORT: 6379
REDIS_PASSWORD: password



TIME_ZONE: Asia/Shanghai

# 模型相关配置
EMBEDDING_MODEL_PATH: C:\opt\maxkb\model\
EMBEDDING_MODEL_NAME: C:\opt\maxkb\model\models--moka-ai--m3e-base

数据库需要自行部署，我这里直接使用服务器部署的 PostgreSql ，部署文件可以看到 MaxKB 目录下，有 installer 文件夹帮助部署，其中有一个 init.sql 文件

• 启动项目

在MaxKB 根目录下运行后端项目；

python main.py dev

 在 MaxKB 根目录下进入 ui 目录运行前端项目；

npm run dev

 账号：admin

密码：MaxKB@123..

注意事项

1. 模型名称为必填项，否则运行会报错；

1. 直接通过pip install volcenginesdkarkruntime 安装报错

此处不能直接安装volcenginesdkarkruntime

而是要安装火山引擎的整个包

pip install volcengine-python-sdk

1. 运行后页面空白，前端报错

原因：因为缺少captcha 库，导致登录页面的验证码无法加载。

pip install captcha