2025-08-08 16:50:16 +08:00

32 KiB
Raw Blame History

title, date, tags
title date tags
大模型 2025-02-18 10:06:57

Ollama

1. 安装

首先需要下载并安装Ollama这是运行模型的基础环境。

image-20250218102658870

2. 下载模型

打开命令行终端,根据需要运行以下命令之一来下载对应版本的模型:

image-20250218104847668

以DeepSeek为例

7B 版本(推荐显存 8G:

ollama pull deepseek-coder:7b

8B 版本(推荐显存 8G:

ollama run huihui_ai/deepseek-r1-abliterated:8b

14B 版本(推荐显存 12G:

ollama run huihui_ai/deepseek-r1-abliterated:14b

32B 版本(推荐显存 32G:

ollama run huihui_ai/deepseek-r1-abliterated:32b

70B 版本(需要高端显卡支持):

ollama run huihui_ai/deepseek-r1-abliterated:70b

3. Ollama 常用命令

在使用 Ollama 时,以下是一些常用的命令操作:

# 启动 Ollama 服务
ollama serve

# 从 Modelfile 创建模型
ollama create <模型名称>

# 显示模型信息
ollama show <模型名称>

# 运行模型
ollama run <模型名称>

# 停止运行中的模型
ollama stop <模型名称>

# 从仓库拉取模型
ollama pull <模型名称>

# 推送模型到仓库
ollama push <模型名称>

# 列出所有已安装的模型
ollama list

# 列出正在运行的模型
ollama ps

# 复制模型
ollama cp <源模型> <目标模型>

# 删除模型
ollama rm <模型名称>

# 显示模型文件
ollama show --modelfile <模型名称>

4. Ollama模型存储目录

  • macOS: ~/.ollama/models
  • Linux: /usr/share/ollama/.ollama/models
  • Windows: C:\Users\%username%\.ollama\models

如何将它们设置为不同的位置?

如果需要使用不同的目录,可以将环境变量 OLLAMA_MODELS 设置为你选择的目录。

注意:在 Linux 上使用标准安装程序时,ollama 用户需要对指定目录有读写权限。要将目录分配给 ollama 用户,请运行 sudo chown -R ollama:ollama <directory>.

请参考上面的部分了解如何在你的平台上设置环境变量。

image-20250218132430850

5. WSL中Ollama使用Windows中的

# 编辑环境变量
vim /etc/profile

# 文件末尾添加
export PATH="$PATH:/mnt/c/Program Files/Ollama"
alias ollama='ollama.exe'

nvidia

cuda-toolkit

下载 CUDA Toolkit Installer

AlmaLinux

wget https://developer.download.nvidia.com/compute/cuda/12.8.1/local_installers/cuda-repo-rhel9-12-8-local-12.8.1_570.124.06-1.x86_64.rpm
sudo rpm -i cuda-repo-rhel9-12-8-local-12.8.1_570.124.06-1.x86_64.rpm
sudo dnf clean all
sudo dnf -y install cuda-toolkit-12-8

Ubuntu

wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2404/x86_64/cuda-ubuntu2404.pin
sudo mv cuda-ubuntu2404.pin /etc/apt/preferences.d/cuda-repository-pin-600
wget https://developer.download.nvidia.com/compute/cuda/12.9.1/local_installers/cuda-repo-ubuntu2404-12-9-local_12.9.1-575.57.08-1_amd64.deb
sudo dpkg -i cuda-repo-ubuntu2404-12-9-local_12.9.1-575.57.08-1_amd64.deb
sudo cp /var/cuda-repo-ubuntu2404-12-9-local/cuda-*-keyring.gpg /usr/share/keyrings/
sudo apt-get update
sudo apt-get -y install cuda-toolkit-12-9

安装 Driver Installer

专有驱动

sudo apt-get install -y cuda-drivers

安装好后,需重启系统才可应用上。

sudo reboot

配置环境变量

vim ~/.bashrc

# 文件末尾添加
# cuda 10.2
export CUDA_HOME=/usr/local/cuda
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/cuda/lib64:/usr/local/cuda/extras/CUPTI/lib64
export PATH=$PATH:$CUDA_HOME/bin

NVIDIA Container Toolkit

下载

With apt: Ubuntu, Debian

国内镜像源安装:

curl -fsSL https://mirrors.ustc.edu.cn/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg

curl -s -L https://mirrors.ustc.edu.cn/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
sed 's#deb https://nvidia.github.io#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://mirrors.ustc.edu.cn#g' | \
sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list

sudo apt-get update

sudo apt-get install -y nvidia-container-toolkit

nvidia-container-cli --version

sudo systemctl restart docker

nvidia-smi

nvidia-smi是nvidia 的系统管理界面 其中smi是System management interface的缩写它可以收集各种级别的信息查看显存使用情况。此外, 可以启用和禁用 GPU 配置选项 (如 ECC 内存功能)。

nvidia-smi

+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 570.86.09              Driver Version: 571.96         CUDA Version: 12.8     |
|-----------------------------------------+------------------------+----------------------+
| GPU  Name                 Persistence-M | Bus-Id          Disp.A | Volatile Uncorr. ECC |
| Fan  Temp   Perf          Pwr:Usage/Cap |           Memory-Usage | GPU-Util  Compute M. |
|                                         |                        |               MIG M. |
|=========================================+========================+======================|
|   0  NVIDIA RTX 4000 Ada Gene...    On  |   00000000:01:00.0 Off |                  Off |
| N/A   50C    P8              7W /   85W |    4970MiB /  12282MiB |      0%      Default |
|                                         |                        |                  N/A |
+-----------------------------------------+------------------------+----------------------+

+-----------------------------------------------------------------------------------------+
| Processes:                                                                              |
|  GPU   GI   CI              PID   Type   Process name                        GPU Memory |
|        ID   ID                                                               Usage      |
|=========================================================================================|
|    0   N/A  N/A           16221      C   /python3.12                           N/A      |
+-----------------------------------------------------------------------------------------+

解释相关参数含义:

GPU本机中的GPU编号

NameGPU 类型

Persistence-M

Fan风扇转速

Temp温度单位摄氏度

Perf表征性能状态从P0到P12P0表示最大性能P12表示状态最小性能

Pwr:Usage/Cap能耗表示

Bus-Id涉及GPU总线的相关信息

Disp.ADisplay Active表示GPU的显示是否初始化

Memory-Usage显存使用率

Volatile GPU-Util浮动的GPU利用率

Uncorr. ECC关于ECC的东西

Compute M.:计算模式

Processes 显示每块GPU上每个进程所使用的显存情况。

持续监控

# 使用 watch 命令,它可以定时执行指定的命令并刷新输出。例如,每隔 1 秒刷新一次 GPU 状态,可以使用以下命令
watch -n 1 nvidia-smi

nvidia-smi -L

#  列出所有可用的 NVIDIA 设备
nvidia-smi -L
GPU 0: NVIDIA RTX 4000 Ada Generation Laptop GPU (UUID: GPU-9856f99a-c32c-fe63-b2ad-7bdee2b12291)

ModelScope

模型下载

安装

pip install modelscope

命令行下载

# 下载完整模型库
modelscope download --model deepseek-ai/DeepSeek-R1-Distill-Qwen-7B
# 下载单个文件到指定本地文件夹以下载README.md到当前路径下“dir”目录为例
modelscope download --model deepseek-ai/DeepSeek-R1-Distill-Qwen-7B README.md --local_dir ./dir

指定下载单个文件(以'tokenizer.json'文件为例)

modelscope download --model 'Qwen/Qwen2-7b' tokenizer.json

指定下载多个个文件

modelscope download --model 'Qwen/Qwen2-7b' tokenizer.json config.json

指定下载某些文件

modelscope download --model 'Qwen/Qwen2-7b' --include '*.safetensors'

过滤指定文件

modelscope download --model 'Qwen/Qwen2-7b' --exclude '*.safetensors'

指定下载cache_dir

modelscope download --model 'Qwen/Qwen2-7b' --include '*.json' --cache_dir './cache_dir'

模型文件将被下载到'cache_dir/Qwen/Qwen2-7b'

指定下载local_dir

modelscope download --model 'Qwen/Qwen2-7b' --include '*.json' --local_dir './local_dir'

模型文件将被下载到'./local_dir'

如果cache_dirlocal_dir参数同时被指定,local_dir优先级高,cache_dir将被忽略。

环境变量配置

默认下载目录

指定modelscope默认下载目录为/AI/modelscope/hub

echo 'export MODELSCOPE_CACHE=/AI/modelscope/hub' >> ~/.bashrc

Anaconda

安装

minicoda

安装 Miniconda — Anaconda 文档

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash ~/Miniconda3-latest-Linux-x86_64.sh
source ~/.zshrc

常用命令

管理环境

  1. 列出所有的环境

    conda env list
    
  2. 查看conda下的包

    conda list
    
  3. 创建环境

    conda create -n env-name [list of package]
    

    -n env-name 是设置新建环境的名字list of package 是可选项,选择要为该环境安装的包 如果我们没有指定安装python的版本conda会安装我们最初安装conda所装的那个版本的python 若创建特定python版本的包环境需键入

    conda create -n env-name python=3.6
    
    
  4. 激活环境

    conda activate env-name
    

    切换到base环境

    conda activate base
    
  5. 删除环境 执行以下命令可以将该指定虚拟环境及其中所安装的包都删除。

    conda remove --name env_name --all
    

    如果只删除虚拟环境中的某个或者某些包则是:

    conda remove --name env_name  package_name
    

问题

  1. conda激活虚拟环境,只显示环境名称,不再显示用户名和当前文件夹

    #在个人环境下修改
    conda activate gatkenv
    
    conda env config vars set PS1='($CONDA_DEFAULT_ENV)[\u@\h \W]$'
    #重启环境就ok了
    
    conda deactivate
    
    conda activate gatkenv
    
    #在所有的虚拟环境下修改,这个命令的意思是在~/.condarc下添加一行
    
    conda config --set env_prompt "({default_env})[\u@\h \W]$"
    
    #取消设置
    
    conda config --remove-key env_prompt
    
  2. conda 安装后没有将conda置为默认

    Do you wish to update your shell profile to automatically initialize conda?
    This will activate conda on startup and change the command prompt when activated.
    If you'd prefer that conda's base environment not be activated on startup,
       run the following command when conda is activated:
    
    conda config --set auto_activate_base false
    
    You can undo this by running `conda init --reverse $SHELL`? [yes|no]
    [no] >>>
    
    You have chosen to not have conda modify your shell scripts at all.
    To activate conda's base environment in your current shell session:
    
    eval "$(/home/user/miniconda3/bin/conda shell.YOUR_SHELL_NAME hook)"
    
    To install conda's shell functions for easier access, first activate, then:
    
    conda init
    
    Thank you for installing Miniconda3!
    
    

    则执行以下shell

    # eval "$(/home/user/miniconda3/bin/conda shell.SHELL_NAME hook)"
    # bash 下
    eval "$(/home/user/miniconda3/bin/conda shell.bash hook)"
    conda init
    # zsh 下
    eval "$(/home/user/miniconda3/bin/conda shell.zsh hook)"
    conda init
    
  3. conda和pip换镜像源

    修改conda通过以下命令进行添加

    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
    conda config --set show_channel_urls yes
    

    修改后可以通过以下命令查看:

    conda info
    

    下载试试:如果两都能看到下载源,那么就更改成功。

    conda install 
    
    Linux系统下:

    linux系统下要到用户的文件夹下新建目录.pip并在目录新建配置文件pip.conf

    mkdir ~/.pip
    cd ~/.pip
    vi pip.conf
    

    编辑内容:

    [global]
    index-url=https://pypi.tuna.tsinghua.edu.cn/simple 
    [install]  
    trusted-host=pypi.tuna.tsinghua.edu.cn
    disable-pip-version-check = true  
    timeout = 6000 
    

    下载试试:

    pip install 
    

Jupyter Notebook

安装

pip install jupyter

运行

jupyter notebook
# 若是root用户执行会出现警告 Running as root is not recommended. Use --allow-root to bypass. 需在后面加上 --allow-root
jupyter notebook --allow-root

UnSloth

vLLM

安装

conda create -n vLLM python=3.12
conda activate vLLM
pip install vLLM

# FlashInfer is optional but required for specific functionalities such as sliding window attention with Gemma 2.
# For CUDA 12.4 & torch 2.4 to support sliding window attention for gemma 2 and llama 3.1 style rope
pip install flashinfer -i https://flashinfer.ai/whl/cu124/torch2.4
# For other CUDA & torch versions, please check https://docs.flashinfer.ai/installation.html
# 也可下载到本地
wget https://github.com/flashinfer-ai/flashinfer/releases/download/v0.2.5/flashinfer_python-0.2.5+cu124torch2.6-cp38-abi3-linux_x86_64.whl#sha256=43d767b912c0c43a04be99595e0123eab9385fc72530a2874b5fb08e3145c0be
pip install flashinfer_python-0.2.5+cu124torch2.6-cp38-abi3-linux_x86_64.whl --no-deps

部署

deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B

CUDA_VISIBLE_DEVICES=0 vllm serve /mnt/e/modelscope/deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B --port 8102 --max-model-len 2048 --api-key token-abc123
  • CUDA_VISIBLE_DEVICES=0: 指定使用的 GPU 设备 ID。 0 表示使用第一块 GPU。如果您有多块 GPU可以根据需要修改为其他 ID (例如 CUDA_VISIBLE_DEVICES=1,2 使用 GPU 1 和 GPU 2)。如果您只有一块 GPU通常使用 0 即可。
  • /mnt/e/modelscope/deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B: 模型路径。 请替换为您在步骤 2 中模型实际保存的路径。
  • --port 8102: 服务端口号。 8102 是服务启动后监听的端口。您可以根据需要修改端口号,例如 --port 8000。在后续代码调用中,需要使用相同的端口号。
  • --max-model-len 16384: 模型最大上下文长度。 16384 表示模型处理的最大输入序列长度。您可以根据您的 GPU 显存大小和需求调整此参数。对于 /mnt/e/modelscope/deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B 模型16384 是一个较大的上下文长度。您可以尝试减小此值以减少显存占用,例如 --max-model-len 2048 或更小。
  • 执行启动命令: 在终端或命令提示符中执行上述 vllm serve 命令。
  • 注意 GPU 显存: 启动 vLLM 服务会占用 GPU 显存。请确保您的 GPU 显存足够运行模型。如果显存不足,可能会导致启动失败或运行缓慢。您可以尝试减小 --max-model-len 参数或使用更小规模的模型。

Qwen/Qwen3-4B

vllm serve ~/modelscope/Qwen/Qwen3-4B --api-key token-abc123 --enable-reasoning --reasoning-parser deepseek_r1 --max_model_len=2048 --gpu_memory_utilization=0.85 

supervisor

sudo vim vLLM-Qwen-Qwen3-4B.conf
[program:vLLM-Qwen-Qwen3-4B.conf]
command=zsh -c "source /home/user/miniconda3/bin/activate && source activate vLLM && vllm serve ~/modelscope/Qwen/Qwen3-4B --api-key token-abc123 --enable-reasoning --reasoning-parser deepseek_r1 --max_model_len=2048 --gpu_memory_utilization=0.85"
user=user
autostart=true
autorestart=true
stderr_logfile=/var/log/supervisor/vLLM-Qwen-Qwen3-4B/err.log
stdout_logfile=/var/log/supervisor/vLLM-Qwen-Qwen3-4B/out.log
stopasgroup=true

Docker

Docker Compose方式

services:
  vllm:
    image: 'vllm/vllm-openai:latest'
    container_name: vllm-Qwen-Qwen3-8B-AWQ
    restart: always
    environment:
      - 'TZ:Asia/Shanghai'
      - 'VLLM_USE_MODELSCOPE:True'
      - 'HF_HUB_OFFLINE:1'
    ports:
      - '8000:8000'
    volumes:
      - /home/user/modelscope:/root/.cache/modelscope
      - /etc/localtime:/etc/localtime:ro
    # 启用 NVIDIA GPU 支持
    # 在 Docker Desktop 上,可能只需要 'gpu'
    # 在 Linux 服务器上,通常是 'nvidia'
    # 你提供的命令行是 --runtime nvidia --gpus all
    # Docker Compose 对应的方式是:
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all # 或者指定具体的GPU数量如 1, 2 等
              capabilities: [gpu] # 确保指定 GPU 能力
    # IPC 模式
    # ipc: host 允许容器与宿主机共享 IPC 命名空间,
    # 这在某些高性能场景下有用,例如共享内存。
    ipc: host
    # 容器启动时执行的命令和参数
    command:
      - --model
      - /root/.cache/modelscope/Qwen/Qwen3-8B-AWQ
      - --served_model_name
      - Qwen/Qwen3-4B # 你希望这个model暴露时的名称如果不填默认为本地模型权重路径
      - --max_model_len
      - "8192" # 支持的最长上下文长度,根据显存大小自行匹配,注意这里需要是字符串
      # --api_key 参数在 vLLM 0.3.x 版本中可能不再是直接的命令行参数,
      # 而是通过环境变量 API_KEY 来设置的。
      # 我已将其移到 environment 部分。
      # 如果你的 vLLM 版本仍然支持命令行参数,请取消注释下一行:
      # - --api_key
      # - "<YOUR-API-KEY-HERE>"
      - --gpu_memory_utilization
      - "0.9"
      - --max-num-seqs
      - "128"
      - --api-key
      - token-abc123
      - --reasoning-parser
      - deepseek_r1

LLama.cpp

llama.cpp是一个基于纯C/C++实现的高性能大语言模型推理引擎,专为优化本地及云端部署而设计。其核心目标在于通过底层硬件加速和量化技术,实现在多样化硬件平台上的高效推理,同时保持低资源占用与易用性。

编译llama.cpp

首先从Github上下载llama.cpp的源码:

git clone https://github.com/ggml-org/llama.cpp
cd llama.cpp

llama.cpp支持多种硬件平台,可根据实际的硬件配置情况选择合适的编译参数进行编译,具体可以参考文档docs/build.md

安装CMAKE

wget https://github.com/Kitware/CMake/releases/download/v4.0.0-rc4/cmake-4.0.0-rc4-linux-x86_64.sh
chmod -R 777 cmake-4.0.0-rc4-linux-x86_64.sh
./cmake-4.0.0-rc4-linux-x86_64.sh
mv cmake-4.0.0-rc4-linux-x86_64/ /usr/local/cmake
echo 'export PATH="/usr/local/cmake/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

sudo dnf install gcc-toolset-13-gcc gcc-toolset-13-gcc-c++
source /opt/rh/gcc-toolset-13/enable

编译CPU版本

cmake -B build
cmake --build build --config Release -j 8

编译GPU版本

编译英伟达GPU版本需要先装好驱动和CUDA,然后执行下面的命令进行编译

cmake -B build -DGGML_CUDA=ON -DGGML_CUDA_ENABLE_UNIFIED_MEMORY=1
cmake --build build --config Release -j 8

编译完成后,可执行文件和库文件被存放在build/bin目录下。

模型下载与转换

首先从魔搭社区下载模型:

pip install modelscope
modelscope download --model deepseek-ai/DeepSeek-R1-Distill-Qwen-7B --local_dir DeepSeek-R1-Distill-Qwen-7B

下载好的模型是以HuggingFacesafetensors格式存放的,而llama.cpp使用的是GGUF格式,因此需要先要把模型转换为GGUF格式:

# 安装python依赖库
pip install -r requirements.txt
# 转换模型
python convert_hf_to_gguf.py DeepSeek-R1-Distill-Qwen-7B/

转换成功后,在该目录下会生成一个FP16精度、GGUF格式的模型文件DeepSeek-R1-Distill-Qwen-7B-F16.gguf

模型量化

FP16精度的模型跑起来可能会有点慢,我们可以对模型进行量化以提升推理速度。

llama.cpp主要采用了分块量化(Block-wise Quantization)和K-Quantization算法来实现模型压缩与加速,其核心策略包括以下关键技术:

  1. 分块量化Block-wise Quantization 该方法将权重矩阵划分为固定大小的子块(如3264元素为一组),每个子块独立进行量化。通过为每个子块分配独立的缩放因子(Scale)和零点(Zero Point),有效减少量化误差。例如,Q4_K_M表示每个权重用4比特存储,且子块内采用动态范围调整。
  2. K-Quantization混合精度量化 在子块内部进一步划分更小的单元(称为“超块”),根据数值分布动态选择量化参数。例如,Q4_K_M将超块拆分为多个子单元,每个子单元使用不同位数的缩放因子(如6bit的缩放因子和4bit的量化值),通过混合精度平衡精度与压缩率。
  3. 重要性矩阵Imatrix优化 通过分析模型推理过程中各层激活值的重要性,动态调整量化策略。高重要性区域保留更高精度(如FP16),低重要性区域采用激进量化(如Q2_K),从而在整体模型性能损失可控的前提下实现高效压缩。
  4. 量化类型分级策略 提供Q2_KQ8_K等多种量化级别,其中字母后缀(如_M_S)表示优化级别:
  5. Q4_K_M:中等优化级别,平衡推理速度与精度(常用推荐)。
  6. Q5_K_S:轻量化级别,侧重减少内存占用

典型场景下,Q4_K_M相比FP16模型可减少70%内存占用,推理速度提升2-3倍,同时保持95%以上的原始模型精度。实际部署时需根据硬件资源(如GPU显存容量)和任务需求(如生成文本长度)选择量化策略。

执行下面的命令可将FP16精度的模型采用Q4_K_M的量化策略进行量化:

./build/bin/llama-quantize DeepSeek-R1-Distill-Qwen-7B/DeepSeek-R1-Distill-Qwen-7B-F16.gguf DeepSeek-R1-Distill-Qwen-7B/DeepSeek-R1-Distill-Qwen-7B-Q4_K_M.gguf Q4_K_M

量化完成后,模型文件由15.2G减少到4.7G

运行模型

模型量化完后,我们就可以运行模型来试试效果了。llama.cpp提供了多种运行模型的方式:

命令行方式

执行下面的命令就可以在命令行与模型进行对话了:

./build/bin/llama-cli -m DeepSeek-R1-Distill-Qwen-7B/DeepSeek-R1-Distill-Qwen-7B-Q4_K_M.gguf -cnv

HTTP Server方式

由于模型是以Markdown格式输出内容,因此用命令行的方式看着不太方便。llama.cpp还提供HTTP Server的方式运行,交互性要好很多。

首先在终端执行命令

./build/bin/llama-server -m DeepSeek-R1-Distill-Qwen-7B/DeepSeek-R1-Distill-Qwen-7B-Q4_K_M.gguf --port 8088

然后打开浏览器,输入地址http://127.0.0.1:8088就可以在网页上与模型进行交互了,非常方便!

Ktransformers

安装

LLaMA-Factory

可参考文章:DeepSeek-R1-7B-Distill模型微调全过程记录LLaMA_Factory训练自己的数据集合并lora微调模型并量化为gguf接入微信实现自动对话回复_微信_qq_53091149-DeepSeek技术社区

安装

# 首先 conda创建环境
conda create -n LLaMA-Factory python=3.12
# 激活环境
conda activate LLaMA-Factory
# 从GitHub上拉去项目代码到当前目录下
git clone https://github.com/hiyouga/LLaMA-Factory.git
# 进入目录
cd LLaMA-Factory
# 安装所需依赖
pip install -e ".[torch,metrics]"
# 启动webui
python src/webui.py 

微调

image-20250320152454509

image-20250320152533756

合并

image-20250320152645802

AutoAWQ量化

安装

conda create -n AutoAWQ python=3.12
conda activate AutoAWQ
pip install torch
pip install autoawq

脚本

默认AutoAWQ会从Huggingface上下载数据集mit-han-lab/pile-val-backup会因为网络问题失败

需事先手动下载通过modelscope

modelscope download --dataset mit-han-lab/pile-val-backup  --local_dir ~/modelscope/mit-han-lab/pile-val-backup

Qwen/Qwen3-4B模型为例

from awq import AutoAWQForCausalLM
from transformers import AutoTokenizer
from datasets import load_dataset

# 加载本地数据集
def load_calib_data():
    data=load_dataset('/home/user/modelscope/mit-han-lab/pile-val-backup', split="validation")
    return [text for text in data["text"] if text.strip() != '' and len(text.split(' ')) > 20]

model_path = '/home/user/modelscope/Qwen/Qwen3-4B'
quant_path = '/home/user/modelscope/Qwen/Qwen3-4B-awq'
quant_config = { "zero_point": True, "q_group_size": 128, "w_bit": 4, "version": "GEMM" }


# Load model
# 加载模型


model = AutoAWQForCausalLM.from_pretrained(
    model_path, **{"low_cpu_mem_usage": True, "use_cache": False}
)
tokenizer = AutoTokenizer.from_pretrained(model_path, trust_remote_code=True)


# Quantize
# 量化

calib_data=load_calib_data()
model.quantize(tokenizer, quant_config=quant_config, calib_data=calib_data)


# Save quantized model
# 保存量化模型


model.save_quantized(quant_path)
tokenizer.save_pretrained(quant_path)


print(f'Model is quantized and saved at "{quant_path}"')

大模型Dense、MoE 与 Hybrid-MoE 架构的比较

在大模型架构设计中Dense全连接、MoE混合专家和Hybrid-MoE混合式MoE是三种主流的参数组织方式它们在模型容量、计算效率和应用场景上存在显著差异。以下从核心原理、技术特点、优缺点及适用场景进行系统对比


1. 核心原理对比

架构类型 核心思想 典型模型
Dense 所有参数对所有输入生效,每层神经元全连接,统一处理所有输入特征。 GPT-3、BERT、LLAMA
MoE 将模型划分为多个“专家”(子网络),每个输入仅激活部分专家,通过路由机制动态分配任务。 Switch Transformer、GShard
Hybrid-MoE 混合Dense和MoE层部分层全连接部分层采用MoE结构平衡计算效率和模型容量。 DeepSeek-MoE、Google GLaM

2. 技术特点与性能对比

维度 Dense MoE Hybrid-MoE
参数规模 总参数量=激活参数量,随层数线性增长。 总参数量高(专家数×专家规模),但激活参数量低(仅激活部分专家)。 介于两者之间MoE层数可控。
计算效率 计算成本高FLOPs与参数量正相关适合小规模模型。 相同参数量下FLOPs显著降低仅激活部分专家 通过调整MoE层比例灵活平衡计算开销。
训练稳定性 收敛稳定,梯度传播路径简单。 路由机制易导致专家负载不均衡,需复杂正则化。 稳定性优于纯MoE但仍需路由优化。
扩展性 参数规模受硬件限制,千亿级后成本陡增。 可扩展至万亿参数如GShard-1.6T),适合超大规模模型。 通过局部MoE化实现高效扩展适配中等规模。
显存占用 高(需存储全部参数梯度)。 显存需求更高(专家参数独立存储)。 显存介于两者之间取决于MoE层占比。
应用场景 通用任务、资源受限场景。 超大规模预训练、多任务学习。 需平衡性能与成本的工业级应用。

3. 优缺点对比

Dense架构

  • 优点
    • 结构简单,训练稳定性高。
    • 参数利用率最大化,适合小规模高精度任务。
  • 缺点
    • 计算成本随参数量指数级增长,难以扩展至超大规模。
    • 显存占用高,限制单卡可训练模型规模。

MoE架构

  • 优点
    • 计算效率高相同FLOPs下模型容量更大。
    • 支持万亿级参数扩展,适合分布式训练。
  • 缺点
    • 路由机制复杂,易出现专家“坍缩”(部分专家未被激活)。
    • 显存和通信开销大,需定制化负载均衡策略。

Hybrid-MoE架构

  • 优点
    • 灵活性高可通过调整MoE层位置平衡性能与成本。
    • 保留关键层的全连接特性,提升任务特定性能。
  • 缺点
    • 需精心设计MoE层分布调参成本较高。
    • 仍面临部分MoE的稳定性挑战。

4. 典型应用场景

架构 适用场景
Dense - 中小规模模型(<100B参数 - 对训练稳定性要求高的任务(如对话生成) - 边缘设备推理
MoE - 超大规模预训练(>500B参数 - 多任务/多模态学习 - 云端高性能计算集群
Hybrid-MoE - 中等规模模型100B-500B参数 - 需兼顾通用性与效率的工业场景 - 长文本处理任务

5. 技术选型建议

  • 选择Dense的条件
    • 资源有限(单卡训练/推理)。
    • 任务单一,无需极高模型容量。
    • 追求极简架构和稳定收敛。
  • 选择MoE的条件
    • 追求极致模型性能如AGI探索
    • 拥有大规模计算集群(千卡级)。
    • 多任务/多模态需求显著。
  • 选择Hybrid-MoE的条件
    • 需平衡模型容量与计算成本。
    • 部分任务依赖全连接层的强表征能力(如逻辑推理)。
    • 希望渐进式扩展模型规模。

6. 未来发展方向

  1. Dense架构优化
    • 参数高效微调LoRA、Adapter
    • 动态稀疏激活如微软的DeepSpeed-MoE
  2. MoE架构改进
    • 更智能的路由机制(如基于强化学习)。
    • 专家共享与分层MoE设计。
  3. Hybrid-MoE创新
    • 自动化MoE层分布搜索NAS技术
    • 异构专家设计(不同专家结构适配不同任务)。

总结

  • Dense:简单可靠,适合资源受限场景,但扩展性差。
  • MoE:计算高效,扩展性强,但工程复杂度高。
  • Hybrid-MoE:折中方案,平衡性能与成本,需精细调优。

实际选型需结合任务需求硬件资源工程能力综合评估。对于大多数企业级应用Hybrid-MoE可能是当前的最优解而科研前沿更倾向于探索纯MoE的极限能力。

Dify

Dify 向量存储机制简述

在 Dify 中文档数据如知识库文档、FAQ、手册等需要经过向量化处理才能用于语义检索和问答增强。其核心处理流程如下图所示

文档(原始文本)
   ↓
Embedding由 OpenAI, Hugging Face, etc. 提供)
   ↓
向量(高维 float 数组)
   ↓
Vector Store默认为 Weaviate
   ↓
Dify 查询时执行语义检索,返回匹配片段

向量存储的作用

Dify 本身不负责存储嵌入向量,而是通过调用第三方向量数据库来管理这些向量。向量数据库的主要职责包括:

  • 存储文本对应的向量数据float 数组)
  • 为每条向量建立索引,支持高效近似/精确搜索
  • 提供语义检索 API如 top-k 相似度查找)
  • 支持元数据管理(如 document_id, source, tags 等)