DeepTutor源码安装与配置

mac/linu系统源码

有四种安装方式，以向导安装为例如下：

1. 向导安装
2. 手动安装
3. docker部署
4. cli部署

下载代码执行安装向导（推荐）

git clone https://github.com/HKUDS/DeepTutor.git && cd DeepTutor   # 下载代码
python -m venv .venv && source .venv/bin/activate                  # 创建虚拟环境
python scripts/start_tour.py                                       # 安装向导

选择语言

选择模式

安装依赖

配置端口

配置model

配置文件.env

向导配置信息最终存储到.env 中也可以直接修改该配置文件；

LLM_BINDING=deepseek
LLM_MODEL=deepseek-v4-flash
LLM_API_KEY=你的key
LLM_HOST=https://api.deepseek.com/v1
LLM_API_VERSION=
LLM_REASONING_EFFORT=
EMBEDDING_BINDING=custom
EMBEDDING_MODEL=Qwen3-Embedding-8B
EMBEDDING_API_KEY=sk-no-key-required
EMBEDDING_HOST=http://localhost:9001/v1/embeddings
EMBEDDING_DIMENSION=4096
EMBEDDING_API_VERSION=
SILICONFLOW_API_KEY=
DASHSCOPE_API_KEY=
COHERE_API_KEY=
JINA_API_KEY=
GEMINI_API_KEY=
SEARCH_PROVIDER=
SEARCH_API_KEY=
SEARCH_PROXY=

本地向量服务

/mnt/d/worker/aiworker/llama.cpp/llama-server \
-m /mnt/d/ProgramData/llm/modelscope/hub/models/Qwen/Qwen3-Embedding-8B-GGUF/Qwen3-Embedding-8B-Q4_K_M.gguf \
--embedding \
--pooling last \
-ub 8192 \
--alias Qwen3-Embedding-8B \
--port 9001 

启动服务

python scripts/start_web.py  

访问页面

http://localhost:3278/

备注：

1. 安装数学动画时缺少包执行：

sudo apt-get install -y libgirepository1.0-dev libcairo2-dev pkg-config python3-dev gir1.2-gtk-3.0

2. 分布启动便于排查问题

1. 启动后台
   source .venv/bin/activate 
   python -m deeptutor.api.run_server
2. 启动web
   cd web && npm install  #先打包（第一次需要打包）
   npm run dev -- -p 3782