.env.example

Source: .env.example · Download source · Example guide
text
# Credentials and deployment bindings, grouped by owner.
# 行为参数在 ditto.yaml；此文件仅存放凭证、地址、模型选择及部署权限。
# Node 24: node --env-file=.env ...; loadRuntimeConfigFile("ditto.yaml", process.env).
# Copy to .env (Git ignored). Never put real credentials in this example.

# Runtime / 应用运行环境
DITTO_RUNTIME_ENV=development
DITTO_RUNTIME_WORKSPACE=.

# Shared / 模型供应商（所有 Worker 复用）
DITTO_SHARED_PROVIDERS=deepseek

# DEEPSEEK
DITTO_SHARED_PROVIDER_DEEPSEEK_KIND=openai-compatible
DITTO_SHARED_PROVIDER_DEEPSEEK_BASE_URL=https://api.deepseek.com
DITTO_SHARED_PROVIDER_DEEPSEEK_API_KEY=
DITTO_SHARED_PROVIDER_DEEPSEEK_MODEL=deepseek-flash

# OPENAI
DITTO_SHARED_PROVIDER_OPENAI_KIND=openai-compatible
DITTO_SHARED_PROVIDER_OPENAI_BASE_URL=https://api.openai.com/v1
DITTO_SHARED_PROVIDER_OPENAI_API_KEY=
DITTO_SHARED_PROVIDER_OPENAI_MODEL=gpt-4o-mini

# GLM
DITTO_SHARED_PROVIDER_GLM_KIND=openai-compatible
DITTO_SHARED_PROVIDER_GLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4
DITTO_SHARED_PROVIDER_GLM_API_KEY=
DITTO_SHARED_PROVIDER_GLM_MODEL=glm-4.7-flash

# CLAUDE
DITTO_SHARED_PROVIDER_CLAUDE_KIND=anthropic
DITTO_SHARED_PROVIDER_CLAUDE_BASE_URL=https://api.anthropic.com/v1
DITTO_SHARED_PROVIDER_CLAUDE_API_KEY=
DITTO_SHARED_PROVIDER_CLAUDE_MODEL=

# GEMINI
DITTO_SHARED_PROVIDER_GEMINI_KIND=gemini
DITTO_SHARED_PROVIDER_GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
DITTO_SHARED_PROVIDER_GEMINI_API_KEY=
DITTO_SHARED_PROVIDER_GEMINI_MODEL=

# LOCAL
DITTO_SHARED_PROVIDER_LOCAL_KIND=openai-compatible
DITTO_SHARED_PROVIDER_LOCAL_BASE_URL=http://127.0.0.1:11434/v1
DITTO_SHARED_PROVIDER_LOCAL_API_KEY=
DITTO_SHARED_PROVIDER_LOCAL_MODEL=

# Shared / Sandbox 部署权限（空值表示禁止）
DITTO_SHARED_SANDBOX_ALLOW_NETWORK=https://api.deepseek.com
DITTO_SHARED_SANDBOX_ALLOW_TOOLS=
DITTO_SHARED_SANDBOX_ALLOW_MCP=
DITTO_SHARED_SANDBOX_ALLOW_SKILLS=
DITTO_SHARED_SANDBOX_ALLOW_READ=false
DITTO_SHARED_SANDBOX_ALLOW_WRITE=false
DITTO_SHARED_SANDBOX_ALLOW_EXECUTE=false

# Workers / CONTEXT 可选缓存；应用创建 Redis SDK client 并注入，Core 不自动连接。
# TTL、keyPrefix 和 Context 策略在 ditto.yaml 的 workers.context。
DITTO_WORKER_CONTEXT_REDIS_URL=redis://127.0.0.1:6379

# Workers / MEMORY 示例数据库连接（由应用数据库适配器读取，Core 不自动连接）
DITTO_WORKER_MEMORY_POSTGRES_URL=postgresql://user:password@127.0.0.1:5432/ditto
DITTO_WORKER_MEMORY_MYSQL_URL=mysql://user:password@127.0.0.1:3306/ditto
# Persistent Memory capability examples (application-owned adapters)
DITTO_WORKER_MEMORY_POSTGRES_TABLE=agent_memories
DITTO_WORKER_MEMORY_QDRANT_URL=http://127.0.0.1:6333
DITTO_WORKER_MEMORY_QDRANT_COLLECTION=agent_memories
DITTO_WORKER_MEMORY_QDRANT_API_KEY=
# Must match DITTO_WORKER_RETRIEVAL_EMBEDDING_MODEL; text-embedding-3-small defaults to 1536.
DITTO_WORKER_MEMORY_EMBEDDING_DIMENSIONS=1536
DITTO_WORKER_MEMORY_MILVUS_ADDRESS=127.0.0.1:19530
DITTO_WORKER_MEMORY_MILVUS_TOKEN=

# Workers / INTERACTION 可选 Brave 网页搜索；行为参数在 workers.interaction.webSearch。
DITTO_WORKER_INTERACTION_BRAVE_SEARCH_API_KEY=

# Workers / INFER 默认模型
DITTO_WORKER_INFER_MODEL_PROVIDER=deepseek
DITTO_WORKER_INFER_MODEL=deepseek-flash

# Workers / RETRIEVAL 可选 embedding（仅显式调用 embeddingConfigFromEnv 时读取）
# 云端/本地 HTTP 共用此配置；本地可改为 http://127.0.0.1:8081/v1 和实际模型名。
# 进程内模型或其他云 SDK 直接注入 Provider，无需配置 HTTP 地址。
# 允许网络的 origin 也需加入 DITTO_SHARED_SANDBOX_ALLOW_NETWORK。
DITTO_WORKER_RETRIEVAL_EMBEDDING_BASE_URL=https://api.openai.com/v1
DITTO_WORKER_RETRIEVAL_EMBEDDING_API_KEY=
DITTO_WORKER_RETRIEVAL_EMBEDDING_MODEL=text-embedding-3-small

# Transport / HTTP Worker 通信认证
DITTO_TRANSPORT_HTTP_WORKER_TOKEN=

# Examples / 可选 SDK 的安装目录；不设置时使用应用本地 node_modules。
# npm install --prefix /tmp/ditto-worker-example-sdk redis pg mysql2 @zilliz/milvus2-sdk-node
DITTO_EXAMPLES_SDK_DIRECTORY=/tmp/ditto-worker-example-sdk

# Application-owned multimodal example configuration (provider must exist in ditto.yaml).
DITTO_EXAMPLE_VISION_PROVIDER=glm
DITTO_EXAMPLE_VISION_MODEL=glm-4.6v-flashx
# DITTO_EXAMPLE_MEDIA_PYTHON=/absolute/venv/bin/python
DITTO_EXAMPLE_ASR_MODEL=tiny.en
DITTO_EXAMPLE_ASR_LANGUAGE=en

# Application-owned CSV/SQLite/chart interpreter.
# DITTO_EXAMPLE_DATA_PYTHON=/absolute/venv/bin/python

# Application web-search QA example (Core stays provider-neutral).
DITTO_EXAMPLE_WEB_SEARCH_ENGINE=mediawiki
DITTO_EXAMPLE_WEB_SEARCH_ENDPOINT=https://en.wikipedia.org/w/api.php
# DITTO_EXAMPLE_WEB_TRUST_BENCHMARK_PROXY=1
.env.example ​

.env.example
