FlowWeave/.env.example at main · debin-ge/FlowWeave · 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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
# ============================================================
# FlowWeave 环境变量模板
# 用法：cp .env.example .env
# ============================================================

# ---------- Docker Compose 基础设施配置（Compose 使用） ----------
# App 对外映射端口（host）
APP_PORT=8080

# PostgreSQL Service
POSTGRES_IMAGE=postgres:16-alpine
POSTGRES_DB=flowweave
POSTGRES_USER=flowweave
POSTGRES_PASSWORD=flowweave
POSTGRES_PORT=5432

# Redis Service
REDIS_IMAGE=redis:7-alpine
REDIS_PORT=6379
REDIS_APPENDONLY=yes

# OpenSearch Service
OPENSEARCH_VERSION=2.19.4
OPENSEARCH_HTTP_PORT=9200
OPENSEARCH_METRICS_PORT=9600
OPENSEARCH_DISCOVERY_TYPE=single-node
# OpenSearch 2.12+ 推荐使用：true=禁用 security 插件（本地开发建议）
OPENSEARCH_SECURITY_DISABLED=true
# 与上面联动：禁用 security 时通常同时禁用 demo config 初始化
OPENSEARCH_DISABLE_DEMO_CONFIG=true
# 仅当 OPENSEARCH_SECURITY_DISABLED=false 时必填（需强密码）
OPENSEARCH_INITIAL_ADMIN_PASSWORD=
OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m
# 中文分词 IK 插件下载地址（必须配置，且版本需与 OPENSEARCH_VERSION 匹配）
OPENSEARCH_IK_PLUGIN_URL=https://your-plugin-download-url/opensearch-analysis-ik.zip

# ---------- 全局配置文件（可选，应用使用） ----------
# 可选：JSON 配置文件路径。加载顺序为：默认值 -> 配置文件 -> 环境变量（例：./config/app.json）
APP_CONFIG_FILE=

# ---------- 服务（应用使用） ----------
HOST=0.0.0.0
PORT=8080
SERVER_READ_TIMEOUT=30
SERVER_WRITE_TIMEOUT=600
# 单次工作流执行超时（秒）
SERVER_RUN_TIMEOUT=300

# ---------- 运行时启动/停机保护（应用使用） ----------
RUNTIME_MIGRATION_TIMEOUT=10
RUNTIME_REDIS_PING_TIMEOUT=3
RUNTIME_MTM_ENSURE_TIMEOUT=5
RUNTIME_SHUTDOWN_TIMEOUT=10
RUNTIME_OPENSEARCH_PING_TIMEOUT=5
RUNTIME_ASYNC_RUN_WORKERS=2
RUNTIME_ASYNC_RUN_POLL_INTERVAL_MS=500
RUNTIME_ASYNC_RUN_TIMEOUT=300

# ---------- 数据库与缓存（应用使用） ----------
# 默认使用 Compose 服务名连接；若改服务端口/账号，可同步修改这些 URL
DATABASE_URL=postgres://flowweave:flowweave@postgres:5432/flowweave?sslmode=disable
DATABASE_MAX_OPEN_CONNS=25
DATABASE_MAX_IDLE_CONNS=5
DATABASE_CONN_MAX_LIFETIME=300

REDIS_URL=redis://redis:6379/0

# ---------- 引擎配置（应用使用） ----------
ENGINE_MAX_WORKERS=4
ENGINE_NODE_TIMEOUT=300
ENGINE_MAX_NODE_STEPS=100

# ---------- LLM Provider (OpenAI 兼容) ----------
# API Key（必填，用于 LLM 节点）
OPENAI_API_KEY=sk-your-api-key-here
# API 基地址（可接入 OpenAI / Azure / DeepSeek / Ollama 等兼容服务）
OPENAI_BASE_URL=https://api.openai.com/v1
# TCP 连接超时（秒）
OPENAI_CONNECT_TIMEOUT=30
# TLS 握手超时（秒）
OPENAI_TLS_HANDSHAKE_TIMEOUT=30

# ---------- 记忆管理 ----------
SUMMARY_LLM_PROVIDER=openai
SUMMARY_LLM_MODEL=gpt-4o-mini

# ---------- Context-Gateway 压缩 ----------
GATEWAY_LLM_PROVIDER=openai
GATEWAY_LLM_MODEL=gpt-4o-mini
CONTEXT_WINDOW_SIZE=128000
COMPRESS_THRESHOLD_RATIO=0.70
COMPRESS_MIN_RECENT_TURNS=4

# ---------- ASR ----------
# 共享挂载目录（API 与 async worker 都需可读写）
ASR_TEMP_DIR=/tmp/flowweave-asr
# 音频文件最大大小（MB）
ASR_MAX_AUDIO_MB=80
# base64 输入最大字符数
ASR_MAX_BASE64_CHARS=12582912
# URL 拉取音频超时（毫秒）
ASR_URL_FETCH_TIMEOUT_MS=30000
# 临时文件清理 TTL（分钟）
ASR_TEMP_FILE_TTL_MINUTES=120

# 腾讯云极速转写
TENCENT_ASR_APP_ID=
TENCENT_ASR_SECRET_ID=
TENCENT_ASR_SECRET_KEY=
TENCENT_ASR_ENGINE_TYPE=16k_zh

# 腾讯云普通转写（异步任务）
TENCENT_REC_SECRET_ID=
TENCENT_REC_SECRET_KEY=
TENCENT_REC_REGION=ap-shanghai
TENCENT_REC_ENGINE_MODEL_TYPE=16k_zh

# 微软 Azure Speech 批量转写（异步任务）
# Endpoint 与 Region 二选一，推荐直接填 Endpoint
AZURE_ASR_ENDPOINT=
AZURE_ASR_REGION=
AZURE_ASR_SUBSCRIPTION_KEY=
AZURE_ASR_API_VERSION=2024-11-15
AZURE_ASR_LOCALE=zh-CN
AZURE_ASR_HTTP_TIMEOUT_MS=30000

# 微软 Azure Translator 文本翻译（func: azure.translate.v1）
# 默认 endpoint 为全局翻译地址，可按需覆盖为自定义资源 endpoint
AZURE_TRANSLATOR_ENDPOINT=https://api.cognitive.microsofttranslator.com
AZURE_TRANSLATOR_REGION=
AZURE_TRANSLATOR_KEY=
AZURE_TRANSLATOR_API_VERSION=3.0
AZURE_TRANSLATOR_HTTP_TIMEOUT_MS=30000

# OpenAI ASR（同步转写 provider: openai_asr）
# OPENAI_ASR_API_KEY 为空时，会回退使用 OPENAI_API_KEY
OPENAI_ASR_BASE_URL=https://api.openai.com/v1
OPENAI_ASR_API_KEY=
OPENAI_ASR_MODEL=gpt-4o-transcribe
OPENAI_ASR_HTTP_TIMEOUT_MS=30000

# 异步任务回调与轮询（统一框架）
ASR_CALLBACK_BASE_URL=
ASR_REC_POLL_INTERVAL_MS=1500
ASR_REC_MAX_WAIT_MS=120000

# ---------- 日志 ----------
LOG_LEVEL=info
LOG_FORMAT=text

# ---------- JWT 鉴权（多租户） ----------
# 必填：服务启动时会校验 JWT_SECRET
JWT_SECRET=test-secret-key-for-dev
JWT_ISSUER=

# ---------- RAG（应用使用） ----------
# 默认使用 Compose 服务名；如切换到外部 OpenSearch，可直接改为外部地址
OPENSEARCH_URL=http://opensearch:9200
OPENSEARCH_USERNAME=
OPENSEARCH_PASSWORD=
# HTTPS + 自签证书时可设为 true；生产建议 false 并使用受信任证书
OPENSEARCH_INSECURE_SKIP_VERIFY=true
# OpenSearch HTTP 客户端超时（秒）
OPENSEARCH_HTTP_TIMEOUT=30
OPENSEARCH_INDEX_PREFIX=rag

RAG_DEFAULT_MODE=bm25
RAG_DEFAULT_TOP_K=5
RAG_CHUNK_SIZE=512
RAG_CHUNK_OVERLAP=128

RAG_EMBEDDING_PROVIDER=openai
RAG_EMBEDDING_MODEL=text-embedding-3-small
RAG_EMBEDDING_DIMS=1536
# Embedding HTTP 超时（秒）
RAG_EMBEDDING_HTTP_TIMEOUT=60
# Embedding 请求批次大小（每批文本条数）
RAG_EMBEDDING_BATCH_SIZE=64

RAG_ENABLE_RERANK=false
RAG_RERANK_PROVIDER=openai
RAG_RERANK_MODEL=gpt-4o-mini

RAG_CACHE_TTL=300
# 检索缓存异步写入超时（秒）
RAG_CACHE_WRITE_TIMEOUT=2
# 文件上传最大大小（MB）
RAG_MAX_FILE_SIZE=50