DeepTutor/.env.example_CN at main · HKUDS/DeepTutor · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
# ==============================================================================
# DeepTutor 环境配置文件
# ==============================================================================
# 请将此文件复制为 `.env` 并填写相应的值。
# [必填] 表示必须配置的字段，[可选] 表示可选配置的字段。

# ==============================================================================
# 服务器端口配置
# ==============================================================================

# [可选] 后端 API 服务器端口
BACKEND_PORT=8001

# [可选] 前端服务器端口
FRONTEND_PORT=3782

# ==============================================================================
# LLM 配置（大语言模型）
# ==============================================================================
# 所有 AI 功能（聊天、研究、解题等）使用的主要大语言模型

# [必填] 服务提供商：openai, azure_openai, anthropic,
# deepseek, openrouter, groq, together, mistral
# ollama, lm_studio, vllm, llama_cpp
LLM_BINDING=openai

# [必填] 模型名称（例如：gpt-4o, deepseek-chat, claude-3-5-sonnet）
LLM_MODEL=gpt-4o

# [必填] LLM 服务提供商的 API 密钥
LLM_API_KEY=sk-xxx

# [必填] API 端点地址
LLM_HOST=https://api.openai.com/v1

# [可选] API 版本（仅 Azure OpenAI 需要填写）
LLM_API_VERSION=

# ==============================================================================
# 向量嵌入（Embedding）配置
# ==============================================================================
# 用于 RAG（检索增强生成）的嵌入模型

# [必填] 服务提供商：openai, azure_openai, jina,
# cohere, huggingface, google, ollama, lm_studio
EMBEDDING_BINDING=openai

# [必填] 模型名称
EMBEDDING_MODEL=text-embedding-3-small

# [必填] API 密钥
EMBEDDING_API_KEY=sk-xxx

# [必填] API 端点地址
EMBEDDING_HOST=https://api.openai.com/v1

# [必填] 向量维度（必须与模型输出维度匹配）
EMBEDDING_DIMENSION=3072

# [可选] API 版本（仅 Azure OpenAI 需要填写）
EMBEDDING_API_VERSION=

# ==============================================================================
# TTS 配置（文本转语音）
# ==============================================================================
# 可选：启用语音朗读功能

# [可选] 服务提供商：openai, azure_openai
TTS_BINDING=openai

# [可选] TTS 模型名称
TTS_MODEL=tts-1

# [可选] API 密钥（使用 OpenAI 时可与 LLM_API_KEY 相同）
TTS_API_KEY=sk-xxx

# [可选] API 端点地址
TTS_URL=https://api.openai.com/v1

# [可选] 语音风格：alloy, echo, fable, onyx, nova, shimmer
TTS_VOICE=alloy

# [可选] API 版本（仅 Azure OpenAI 需要填写）
TTS_BINDING_API_VERSION=

# ==============================================================================
# 搜索配置（网络搜索）
# ==============================================================================
# 可选：启用网络搜索功能

# [可选] 搜索服务提供商：perplexity, tavily, serper, jina, exa
SEARCH_PROVIDER=perplexity

# [可选] 所选搜索服务的 API 密钥
SEARCH_API_KEY=pplx-xxx

# ==============================================================================
# 云端部署配置
# ==============================================================================
# 部署到云端或远程服务器时需要配置

# [可选] 云端部署时的外部 API 基础地址
# 部署到远程服务器时，请设置为服务器的公网地址
# 示例：https://your-server.com:8001 或 https://api.yourdomain.com
NEXT_PUBLIC_API_BASE_EXTERNAL=

# [可选] 直接 API 基础地址（上述配置的替代方案）
NEXT_PUBLIC_API_BASE=

# ==============================================================================
# 调试与开发配置
# ==============================================================================

# [可选] 禁用 SSL 证书验证（生产环境不建议启用）
DISABLE_SSL_VERIFY=false

# ==============================
# HuggingFace / MinerU（可选）
# ==============================

# 使用 HuggingFace 镜像站点（可选）
# HF_ENDPOINT=https://your-hf-mirror.example.com

# HuggingFace 缓存目录（建议：Docker 场景配合挂载该目录以复用缓存）
# HF_HOME=/app/data/hf

# 强制离线模式（前提：模型已在上述缓存目录中下载好）
# HF_HUB_OFFLINE=1