wsl部署python版本QAnything（踩坑）

windows下安装wsl

#安装并设置版本为2
wsl install
wsl --set-default-version 2
# 查看linux情况
wsl -l -v

如果有其他问题可以看：windows下安装docker desktop并指定安装目录及汉化

进入ubuntu并下载安装conda

wsl --distribution Ubuntu
# 首次进入需要设置账号密码：ch*/**
# 下载anaconda
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
# 安装
bash Miniconda3-latest-Linux-x86_64.sh
# 选择 yes
# 空格 翻页
# 选择 yes

# 后面的是配置conda环境，没配置的话就是默认

激活python虚拟环境

source ~/.bashrc
# 如果没变化，就先编辑配置conda环境变量
vi ~/.bashrc
# 最文件最后添加以下配置
export PATH="~/anaconda3/bin":$PATH
source ~/miniconda3/bin/activate #修改终端的默认 python 为 anaconda
# 保存退出编辑并执行
source ~/.bashrc
# 默认激活的是base虚拟环境
# 创建新的环境，指定路径 0-WSL\ubuntu\conda_envs
conda create --prefix /mnt/e/0-WSL/ubuntu/conda_envs/qanything-python python=3.10
# 激活新的环境
# conda activate /mnt/e/0-WSL/ubuntu/conda_envs/qanything-python
# 如果想方便激活该环境，通过 conda config 设置 envs_dirs 来让 Conda 认识这个路径。
conda config --add envs_dirs /mnt/e/0-WSL/ubuntu/conda_envs
conda activate qanything-python

代码拉取及安装依赖包

# 切换到存放代码的目录
cd /mnt/e/0-RAG
# git拉取代码：也可以自己下载丢到自己想要存放的目录下
git clone -b qanything-python https://github.com/netease-youdao/QAnything.git
# 切换到代码目录下
cd QAnything
# 根据requirements.txt文件列出的依赖安装python包
# 科学上网或者国内源
# pip install -r requirements.txt  
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple  -r requirements.txt

• pip install报错：

  • 没有找到gcc
    

  • 解决：安装gcc编译器

    # 安装
    sudo apt-get update
    sudo apt-get install build-essential
    # 查询gcc版本信息
    gcc --version
    

    

启动 （启动有点慢，大概需要5分钟）

• QAnything\scripts下复制ollam的启动脚本进行修改保存为ollama_cpu_wsl.sh

  #!/bin/bash
  bash scripts/base_run.sh -s "LinuxOrWSL" -w 4 -m 19530 -q 8777 -c -o -b 'http://localhost:11434/v1' -k 'ollama' -n 'deepseek-r1:7b' -l '4096'
  

• 执行命令启动

  bash scripts/ollama_cpu_wsl.sh 
  

• 报错

  File "/mnt/e/0-WSL/ubuntu/conda_envs/qanything-python/lib/python3.10/site-packages/openai/_base_client.py", line 793, in __init__
      self._client = http_client or SyncHttpxClientWrapper(
  TypeError: Client.__init__() got an unexpected keyword argument 'proxies'
  

  • 原因:安装openai包时没指定httpx包版本，httpx包在11.28进行更新，安装了httpx 0.28.0 版本的包导致报错

    

  • 解决方法

    • 1、指定httpx包版本为0.27.2： pip install httpx==0.27.2
    • 2、安装openai包>=1.55.3版本： pip install openai>=1.55.3

• 运行结果

  

• 浏览器访问：http://localhost:8777/qanything
  
  ollama部署大模型的可以参考：使用Ollama在本地运行AI大模型（gemma、deepseek等）及UI整合（chatbox、Cherry Studio、Page Assist等）

使用遇到的问题及解决

• 上传文件后解析失败。看日志打印是找不到NLTK（punkt_tab、averaged_perceptron_tagger_eng）
  
  

• 下载：

  • nltk.org 找到相对应的报错包下载即可（punkt_tab、averaged_perceptron_tagger_eng）
  • github 直接下载在packages下相对应的文件夹下找也可以
  • 百度网盘

• 解压后根据报错信息丢进去：Searched in 列表的路径 + Attempted to load 的路径 即是完整路径
  例如我本地的：

  • E:\0-RAG\QAnything\qanything_kernel\nltk_data\taggers
  • E:\0-RAG\QAnything\qanything_kernel\nltk_data\tokenizers

好了，能正常使用了。剩下的慢慢研究吧~