基于Ubuntu 20.04的MiniCPM-V-2_6保姆级安装与部署教程

发布时间:2026/7/16 6:34:51

基于Ubuntu 20.04的MiniCPM-V-2_6保姆级安装与部署教程 基于Ubuntu 20.04的MiniCPM-V-2_6保姆级安装与部署教程想试试那个能看懂图片还能跟你聊天的多模态大模型MiniCPM-V-2_6吗但一看到复杂的部署步骤就头疼别担心这篇教程就是为你准备的。咱们今天不谈复杂的原理就聊一件事怎么在Ubuntu 20.04系统上从零开始一步一步把这个模型跑起来。我理解很多朋友可能对Linux命令行有点发怵或者被各种依赖、驱动搞得晕头转向。所以这篇教程会尽量用大白话把每一步都掰开揉碎了讲。无论你是刚接触AI部署的新手还是想快速验证模型效果的开发者跟着这篇指南走都能顺利搞定。咱们的目标很简单让你在半小时内看到模型运行起来的效果。1. 开始之前你需要准备什么在动手之前我们先花两分钟看看需要准备哪些东西做到心里有数。这就像做饭前先备好菜能省去很多中途手忙脚乱的时间。一台Ubuntu 20.04的电脑或服务器。这是我们的“厨房”。为什么是20.04因为这个版本长期支持社区资源丰富遇到问题也更容易找到解决方案。当然其他版本的Ubuntu理论上也可以但为了减少不必要的麻烦咱们就按20.04来。一张支持CUDA的NVIDIA显卡。这是我们的“灶台”负责提供算力。MiniCPM-V-2_6模型推理需要GPU加速没有显卡用CPU跑会非常慢。显存建议8GB或以上这样运行起来会更流畅。一个可以访问互联网的环境。我们需要下载模型文件和一些软件包网络畅通是必须的。基本的命令行操作知识。不需要你是Linux大神只要知道怎么打开终端Terminal会输入cd、ls这些基本命令就足够了。后面的每一步我都会给出具体的命令你复制粘贴执行就行。好了工具和材料齐了咱们系上围裙开始干活。2. 第一步搭建基础环境安装驱动和CUDA这一步是打地基虽然有点枯燥但非常重要。地基打牢了后面盖房子运行模型才稳当。咱们按顺序来先检查再安装。2.1 检查你的显卡和驱动首先打开终端。你可以按CtrlAltT快捷键或者在应用菜单里搜索“Terminal”。在终端里输入下面的命令看看你的显卡信息nvidia-smi如果看到了类似下面的输出显示了你显卡的型号、驱动版本和CUDA版本那么恭喜你驱动可能已经装好了。记下右上角显示的CUDA版本比如12.4后面会用到。----------------------------------------------------------------------------- | NVIDIA-SMI 535.161.07 Driver Version: 535.161.07 CUDA Version: 12.4 | |--------------------------------------------------------------------------- | GPU Name TCC/WDDM | Bus-Id Disp.A | Volatile Uncorr. ECC | | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | || | 0 NVIDIA GeForce ... WDDM | 00000000:01:00.0 On | N/A | | N/A 50C P8 10W / N/A | 100MiB / 8192MiB | 0% Default | ---------------------------------------------------------------------------如果系统提示“command not found”那就说明NVIDIA驱动还没安装。别急咱们来装一个。对于Ubuntu 20.04安装官方驱动比较方便的方法是使用ubuntu-drivers工具。在终端里依次执行sudo apt update sudo apt install ubuntu-drivers-common sudo ubuntu-drivers autoinstall最后一条命令autoinstall会自动检测你的显卡型号并安装推荐的驱动。安装完成后一定要重启你的电脑。sudo reboot重启后再次打开终端输入nvidia-smi应该就能看到显卡信息了。2.2 安装CUDA ToolkitCUDA是NVIDIA推出的并行计算平台我们的模型运行需要它。安装CUDA有个小技巧不一定非要安装最新版选择与你的驱动兼容、并且模型推荐的版本更稳妥。MiniCPM-V-2_6通常对CUDA 11.7或11.8支持良好。这里我们以CUDA 11.8为例。访问NVIDIA官网找下载链接有点麻烦我们可以直接用APT仓库安装。首先添加NVIDIA的CUDA仓库密钥和源wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2004/x86_64/cuda-keyring_1.1-1_all.deb sudo dpkg -i cuda-keyring_1.1-1_all.deb sudo apt update接下来安装CUDA 11.8。注意我们安装的是cuda-toolkit-11-8这个元包它会自动拉取所有必要的组件。sudo apt install cuda-toolkit-11-8这个安装过程可能需要一些时间取决于你的网速。安装完成后我们需要让系统知道CUDA装在哪里。编辑你的用户环境配置文件如果你用的是bash shellecho export PATH/usr/local/cuda-11.8/bin${PATH::${PATH}} ~/.bashrc echo export LD_LIBRARY_PATH/usr/local/cuda-11.8/lib64${LD_LIBRARY_PATH::${LD_LIBRARY_PATH}} ~/.bashrc然后让配置立刻生效source ~/.bashrc最后验证一下CUDA是否安装成功nvcc --version如果命令输出了CUDA编译器的版本信息比如release 11.8那么这一步就大功告成了。2.3 安装cuDNNcuDNN是深度神经网络加速库可以理解为CUDA的“增强包”。我们需要去NVIDIA官网下载但需要注册一个免费账号。访问 NVIDIA cuDNN官网请自行搜索登录你的账号。找到对应CUDA 11.x版本的cuDNN下载。比如选择“Download cuDNN v8.x.x for CUDA 11.x”。下载三个Debian本地安装包.deb文件libcudnn8_x.x.x-1cuda11.x_amd64.deb(运行时库)libcudnn8-dev_x.x.x-1cuda11.x_amd64.deb(开发库)libcudnn8-samples_x.x.x-1cuda11.x_amd64.deb(样例)下载完成后假设文件在~/Downloads目录在终端里进入该目录并安装cd ~/Downloads sudo dpkg -i libcudnn8*.deb安装完成后可以运行一个官方样例来测试可选cp -r /usr/src/cudnn_samples_v8/ $HOME cd $HOME/cudnn_samples_v8/mnistCUDNN make clean make ./mnistCUDNN如果输出“Test passed!”说明cuDNN安装配置正确。3. 第二步准备Python和项目环境基础环境搭好了现在来准备模型运行的“软件环境”。我们用Python虚拟环境这就像给这个项目单独准备一个工具箱不会弄乱你系统里其他的Python项目。3.1 安装Python和必备工具Ubuntu 20.04默认可能安装了Python 3.8我们确保一下并安装一些必要的工具sudo apt update sudo apt install python3 python3-pip python3-venv git wget curl -ypython3-venv是用来创建虚拟环境的git是用来下载代码的wget和curl是下载工具。3.2 创建虚拟环境并激活找一个你喜欢的位置创建一个项目文件夹并在里面创建虚拟环境。我习惯在用户目录下操作cd ~ mkdir minicpm_project cd minicpm_project python3 -m venv minicpm_env这行命令创建了一个名为minicpm_env的虚拟环境。现在激活它source minicpm_env/bin/activate激活后你的命令行提示符前面通常会显示(minicpm_env)这表示你现在已经在这个虚拟环境里了。接下来所有pip install的操作都只会影响这个环境。3.3 安装PyTorch和深度学习库这是关键一步我们要安装PyTorch这是运行模型的核心框架。一定要去 PyTorch官网 获取安装命令选择和我们CUDA 11.8匹配的版本。对于我们的环境Linux, Pip, CUDA 11.8官网推荐的命令通常是pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118这个命令会安装支持CUDA 11.8的PyTorch。安装完成后可以在Python里简单验证一下python3 -c import torch; print(torch.__version__); print(torch.cuda.is_available())如果输出PyTorch版本号并且第二行打印出True说明PyTorch安装成功并且能识别到你的GPU。4. 第三步获取MiniCPM-V-2_6模型环境准备好了现在去把“主角”——模型请过来。模型主要包括两部分代码和权重文件。4.1 下载模型代码MiniCPM-V-2_6的代码通常托管在GitHub上。我们使用git命令来克隆下载代码仓库cd ~/minicpm_project git clone https://github.com/OpenBMB/MiniCPM-V.git cd MiniCPM-V如果网络不太稳定git clone可能会比较慢或者失败。你也可以在GitHub页面手动下载ZIP包然后解压到当前目录。4.2 安装项目依赖进入代码目录后一般会有一个requirements.txt文件里面列出了项目运行需要的所有Python包。我们用pip一键安装pip install -r requirements.txt这个过程会安装transformers、accelerate等一堆依赖包耐心等待即可。如果遇到某个包安装特别慢可以考虑临时切换国内的pip镜像源。4.3 下载模型权重文件模型权重文件是训练好的模型参数体积比较大通常有几个GB。我们需要从模型发布平台比如Hugging Face或ModelScope下载。这里以Hugging Face为例我们可以使用git-lfs大文件存储来克隆。首先确保安装了git-lfssudo apt install git-lfs git lfs install然后克隆权重仓库仓库地址需要根据模型卡信息确定例如cd ~/minicpm_project git clone https://huggingface.co/openbmb/MiniCPM-V-2_6请注意由于权重文件很大下载可能需要很长时间并且需要足够的磁盘空间约12GB。如果网络中断可以使用git lfs pull继续拉取。如果觉得用git-lfs下载太慢或太麻烦还有一个更简单的方法使用星图GPU平台的一键部署这个我们放在最后一部分讲它能完美解决下载和环境的难题。5. 第四步运行你的第一个模型示例万里长征最后一步让我们写一个简单的脚本看看模型能不能正常工作。在项目目录下比如~/minicpm_project创建一个Python脚本比如叫run_demo.pyimport torch from transformers import AutoModel, AutoTokenizer # 1. 指定模型路径请修改为你实际下载权重的路径 model_path ./MiniCPM-V-2_6 # 2. 加载tokenizer和模型 print(正在加载tokenizer和模型请稍候...) tokenizer AutoTokenizer.from_pretrained(model_path, trust_remote_codeTrue) model AutoModel.from_pretrained(model_path, trust_remote_codeTrue, torch_dtypetorch.float16) # 3. 将模型放到GPU上 model model.to(devicecuda) model.eval() # 设置为评估模式 print(模型加载完毕) # 4. 准备一个简单的对话 # 第一轮纯文本问答 question1 请用一句话介绍一下你自己。 response1, _ model.chat(textquestion1, tokenizertokenizer) print(f用户: {question1}) print(f模型: {response1}) print(- * 40) # 第二轮带图片的问答 (这里需要一张图片我们先模拟) # 实际使用时需要将图片路径替换为你的图片 print(提示下一轮需要图片输入请准备一张图片并修改代码中的路径。) # 假设我们有一张猫的图片 # image_path /path/to/your/cat.jpg # response2, _ model.chat(imageimage_path, text图片里是什么动物, tokenizertokenizer) # print(f用户: 图片里是什么动物) # print(f模型: {response2}) print(\n基础文本对话测试完成你可以尝试修改代码启用图片对话部分。)运行这个脚本cd ~/minicpm_project python run_demo.py如果一切顺利你会看到终端开始加载模型可能会显示加载进度条然后输出模型对第一个文本问题的回答。看到模型生成的文字就说明你的部署成功啦第一次运行加载模型会比较慢因为要把权重从硬盘读到显存。加载完成后后续的对话速度就会快很多。6. 更简单的选择使用星图GPU平台一键部署如果你觉得上面这些步骤还是太繁琐或者卡在了驱动安装、权重下载这些环节别灰心。现在有一个对新手和想快速验证想法的人超级友好的选择云平台的预置镜像。这就像你去餐厅吃饭不用自己买锅碗瓢盆、买菜、研究菜谱餐厅已经把一道招牌菜给你做好了你直接点单就能吃。星图GPU平台就提供了这样的“AI模型餐厅”。它的好处非常明显免环境配置平台已经预装好了CUDA、PyTorch、Python环境以及模型所需的所有依赖。你完全不用操心前面第一、二、三步。免模型下载模型权重文件已经内置在镜像里省去了动辄几十GB的下载时间和硬盘空间。开箱即用创建实例后通常通过Web界面或预置的Jupyter Notebook几分钟内就能直接运行模型示例代码。资源灵活可以根据需要选择不同算力的GPU用完了就释放按需付费特别适合学习和测试。对于MiniCPM-V-2_6这类热门模型很多云平台都提供了预置的镜像。你只需要在平台上选择带有该模型镜像的GPU实例。启动实例。按照镜像提供的说明通常是一个README或启动脚本直接运行demo。这能将部署时间从几小时缩短到几分钟让你把精力完全集中在模型的使用和效果测试上。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。

相关新闻