百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文
手把手教本地部署Xinference + deepseek-R1、reranker-v2、bge-m3

手把手教本地部署Xinference + deepseek-R1、reranker-v2、bge-m3

  • 网站名称:手把手教本地部署Xinference + deepseek-R1、reranker-v2、bge-m3
  • 网站分类:技术文章
  • 收录时间:2025-07-08 14:40
  • 网站地址:

进入网站

“手把手教本地部署Xinference + deepseek-R1、reranker-v2、bge-m3” 网站介绍

Xinference 作为本地 AI 推理框架,相较于 Ollama 和其他推理方案,有以下几个核心优势:

1. 多模型支持。

Xinference 兼容 大量 LLM(大语言模型),不仅支持 LLaMA 和 Mistral,还包括:

国产模型:ChatGLM、Qwen(通义千问)、Baichuan(百川)等

开源模型:Mistral、LLaMA、Gemma、Phi 等多模态支持:

部分版本支持 语音、图像、文本 处理。

2. 分布式 & 多 GPU 支持。

兼容 OpenAI API,可以无缝替换 OpenAI 的 API,方便集成现有应用。

3. API 兼容性 & 扩展性。

兼容 OpenAI API,可以无缝替换 OpenAI 的 API,方便集成现有应用。支持 Web UI:提供管理界面,可以直接在浏览器里管理模型,而 Ollama 主要是命令行操作。

4. 高效的推理优化。

比 Ollama 更适合 AI 研究人员、企业级应用,而 Ollama 更适合个人用户。

5. 适用于科研 & 生产环境。

比 Ollama 更适合 AI 研究人员、企业级应用,而 Ollama 更适合个人用户。

但是Xinference安装很复杂,需要 PyTorch, transformers, llama-cpp-python 等库,对环境要求较高。

一、本地手动安装Xinference。

1、 需要提前安装好的组件

安装python,直接到如下网站下载安装即可。我用的python 3.10.11是可以的。

https://www.python.org/downloads/release/python-31011/

PyTorch

For most users (CPU & CUDA 11+): pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

For CPU-only (no GPU support needed): pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

检测是否安装好:python -c "import torch; print(torch.__version__)",输入如下图即安装好了

python -c "import torch; print(torch.__version__)"

安装CUDA

可以去官网下载,安装,然后重启电脑

Win11 : https://developer.nvidia.com/cuda-downloads?target_os=Windows&target_arch=x86_64&target_version=11&target_type=exe_network

Win 10: https://developer.nvidia.com/cuda-downloads?target_os=Windows&target_arch=x86_64&target_version=10&target_type=exe_network

检测是否安装好:在PowerShell中输入nvcc –version,显示如图即安装好了。同时可以输入python -c "import torch; print(torch.cuda.is_available())",显示为true,表明PyTorch 检测到了 CUDA。

python -c "import torch; print(torch.cuda.is_available())"

安装Visual Studio 2022,需要安装的组件如图所示:

此部分安装好后,可以在PowerShell中输入cmake –version,回车,如图显示则表明cmake安装成功。如果显示命令无法识别,可以自行去”系统>“系统信息”>”高级系统设置”>“环境变量”>“系统变量”>中找到PATH变量,鼠标左键双击,兴建以下PATH,C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin。

cmake –version
C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin

此部分安装好后,可以在PowerShell中输入cl,回车,如图显示则表明C++编译器安装成功。如果显示命令无法识别,可以自行去”系统>“系统信息”>”高级系统设置”>“环境变量”>“系统变量”>中找到PATH变量,鼠标左键双击,兴建以下PATH,一个是C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.43.34808\bin\Host”。

C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.43.34808\bin\Host”

2、 本地编译Xinference

建立文件夹命名为“Xinference”,选中地址栏,输入CMD,回车即进入到命令行输入界面,然后输入命令 pip install xinference[all] 命令,回车,等待编译完成。成功编译完成如下图

pip install xinference[all]

此步骤容易出错,以下为纠错步骤,如没有遇到错误直接下一步。

错误1、安装过程中如果出现如图提示错误,说明缺少PyTorch,可以输入命令安装,如果有独立显卡的输入pip install torch torchvision torchaudio --index-url
https://download.pytorch.org/whl/cu118,如果没有独立显卡的输入 pip install torch torchvision torchaudio --index-url
https://download.pytorch.org/whl/cpu

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

安装完后,输入命令python -c "import torch; print(torch.cuda.is_available())",如果输出为true,即安装正确了。

python -c "import torch; print(torch.cuda.is_available())"

错误2,如图。如果电脑没有安装CUDA,可以去
https://developer.nvidia.com/cuda-downloads安装合适版本。

错误3、如果出现“llama-cpp-python”模块报错,可以用命令git clone
https://github.com/abetlen/llama-cpp-python.git进行安装。

如果安装无法拉取文件,可以下载zip文件本地安装。但是注意下载的zip解压后llama-cpp-python-main\vendor\llama.cpp文件夹中文件缺失,可以自行拉取,方法如下:PowerShell进入到解压文件C:\Users\你的用户名\llama-cpp-python-main\vendor\llama.cpp之下,输入git clone
https://github.com/ggml-org/llama.cpp.git拉取文件。文件拉取完成后,依次输入命令“git submodule update --init –recursive”、“cd ../..”、“pip install .”即可安装安装完成。

git clone https://github.com/ggml-org/llama.cpp.git
git submodule update --init –recursive
cd ../..
pip install

检测是否安装成功,打开PowerShell输入python>import llama_cpp>print(llama_cpp.__version__),没有报错即成功,如图

python
import llama_cpp
print(llama_cpp.__version__)

错误4、某些小伙伴安装后可能会缺少socksio-1.0.0库,PowerShell中输入pip install socksio安装即可。

pip install socksio

3、 PowerShell输入命令xinference-local运行程序

打开浏览器输入http://127.0.0.1:9997访问Xinference,如图。下次再运行的时候PowerShell中输入xinference-loca即可。

xinference-local

二、在Xinference中部署本地大模型

1、 部署语言模型(LANGUAGE MODELS):蒸馏版deepseek R1模型。

在PowerShell中通过命令xinference-local,启动Xinference,然后在浏览器中访问http://127.0.0.1:9997/,进入图形化界面。点击左上“Launch Model”>“LANGUAGE MODELS”>” deepseek-r1-distill-qwen”,按照下图进行设置。

点击火箭图标后,就开始本地部署。可以参看PowerShell中正在运行的内容,如下图

安装好后,回到http://127.0.0.1:9997/,点击“Running Models”就可以看到正在运行的语言模型了,如图所示

2、 部署嵌入模型(EMBEDDING MODELS):bge-m3。

在PowerShell中通过命令xinference-local,启动Xinference,然后在浏览器中访问http://127.0.0.1:9997/,进入图形化界面。点击左上“Launch Model”>“EMBEDDING MODELS”>” bge-m3”,使用默认参数即可。

安装好后,回到http://127.0.0.1:9997/,点击“Running Models”就可以看到正在运行的模型了,如图所示


3、 部署重排序模型(RERANK MODELS):bge-reranker-v2-m3

在PowerShell中通过命令xinference-local,启动Xinference,然后在浏览器中访问http://127.0.0.1:9997/,进入图形化界面。点击左上“Launch Model”>“RERANK MODELS”>” bge-reranker-v2-m3”, 使用默认参数即可。

三、如果你装有Docker,也可以在本地用Docker部署Xinference。

1、个人部署

docker run -it --name xinference -d -p 9997:9997 -e XINFERENCE_MODEL_SRC=modelscope -e XINFERENCE_HOME=/workspace -v /yourworkspace/Xinference:/workspace --gpus all xprobe/xinference:latest xinference-local -H 0.0.0.0

2、也可以分布式部署

docker run -it --name xinference-master -d -p 9997:9997 -e XINFERENCE_MODEL_SRC=modelscope -e XINFERENCE_HOME=/workspace -v /yourworkspace/Xinference:/workspace --gpus all xprobe/xinference:latest xinference-supervisor -H "${master_host}"
docker run -it --name xinference-worker -d -p 16500:16500 -e XINFERENCE_MODEL_SRC=modelscope -e XINFERENCE_HOME=/workspace -v /yourworkspace/Xinference:/workspace -e "http://${supervisor_host}:9997" -H "${worker_host}"

3、在浏览器中访问http://127.0.0.1:9997/,进入图形化界面。在Xinference部署大模型见二中所述。

写作不易,麻烦点个红星和关注!

下篇发布Xinference+Dify部署。