BlogAgent/.env.example at main · RaulMermans/BlogAgent · 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
# ---------------------------------------------------------------------------
# Worker secret (optional — lightweight demo protection for /run endpoints)
# ---------------------------------------------------------------------------

# If set, POST /run and GET /run?topic=... require a matching secret.
# Pass via header X-BlogAgent-Secret, JSON body field worker_secret,
# or query param worker_secret (GET only).
# /health, /, and /app remain public regardless.
# Leave empty to disable secret checking entirely.
BLOGAGENT_WORKER_SECRET=

# ---------------------------------------------------------------------------
# LLM provider configuration
# ---------------------------------------------------------------------------

# LLM provider for Editor Agent and Fact-Check Evaluator.
# Options: mock (default, deterministic — no API key required), anthropic, openai, google
BLOGAGENT_LLM_PROVIDER=mock

# Model override. Leave empty to use provider default.
# anthropic default: claude-sonnet-4-6
# openai default:    gpt-4o-mini
# google default:    gemini-2.5-flash  (or BLOGAGENT_GOOGLE_MODEL if set)
BLOGAGENT_LLM_MODEL=

# Timeout in seconds for LLM API calls
BLOGAGENT_LLM_TIMEOUT_SECONDS=60

# API keys — required only for the corresponding provider
ANTHROPIC_API_KEY=
OPENAI_API_KEY=
GOOGLE_API_KEY=

# Google model selection (used when BLOGAGENT_LLM_PROVIDER=google)
# BLOGAGENT_LLM_MODEL takes priority; these are Google-specific overrides.
BLOGAGENT_GOOGLE_MODEL=gemini-2.5-flash
BLOGAGENT_GOOGLE_LOW_COST_MODEL=gemini-2.5-flash-lite
BLOGAGENT_GOOGLE_PREMIUM_MODEL=gemini-2.5-pro

# Enable real LLM calls for the Editor Agent (research plan, outline, draft, revision).
# Set to "true" only when BLOGAGENT_LLM_PROVIDER is not "mock".
# Default: false — uses deterministic mock output; safe for all tests.
BLOGAGENT_USE_LLM_EDITOR=false

# Enable real LLM calls for claim extraction and fact-check judgment.
# Set to "true" only when BLOGAGENT_LLM_PROVIDER is not "mock".
# Default: false — uses deterministic heuristic logic; safe for all tests.
BLOGAGENT_USE_LLM_FACTCHECK=false

# Enable LLM-backed semantic citation verification per claim.
# When true, citation_matcher calls an LLM to judge each claim against source excerpts.
# Falls back to deterministic keyword-overlap heuristic on any provider failure.
# Default: false — deterministic heuristic is used; safe and free for all tests.
# Note: enabling this incurs LLM API cost and requires a real provider.
BLOGAGENT_USE_LLM_CITATION_JUDGE=false

# ---------------------------------------------------------------------------
# Search provider configuration
# ---------------------------------------------------------------------------

# Controls which backend web_search uses.
# Options: mock (default, deterministic), tavily
BLOGAGENT_SEARCH_PROVIDER=mock

# Tavily API key — required when BLOGAGENT_SEARCH_PROVIDER=tavily
TAVILY_API_KEY=

# HTTP timeout in seconds for webpage_extract and Tavily search calls
BLOGAGENT_HTTP_TIMEOUT_SECONDS=15

# Maximum number of search results to fetch per query
BLOGAGENT_MAX_SEARCH_RESULTS=5

# ---------------------------------------------------------------------------
# Quick-start configurations (copy relevant block to your shell)
# ---------------------------------------------------------------------------

# Google live editor (recommended affordable provider):
# BLOGAGENT_LLM_PROVIDER=google
# BLOGAGENT_USE_LLM_EDITOR=true
# GOOGLE_API_KEY=your_key_here
# BLOGAGENT_GOOGLE_MODEL=gemini-2.5-flash

# Google low-cost mode:
# BLOGAGENT_LLM_PROVIDER=google
# BLOGAGENT_USE_LLM_EDITOR=true
# GOOGLE_API_KEY=your_key_here
# BLOGAGENT_GOOGLE_MODEL=gemini-2.5-flash-lite

# Google with citation judge:
# BLOGAGENT_LLM_PROVIDER=google
# BLOGAGENT_USE_LLM_EDITOR=true
# BLOGAGENT_USE_LLM_CITATION_JUDGE=true
# GOOGLE_API_KEY=your_key_here

# Anthropic editor:
# BLOGAGENT_LLM_PROVIDER=anthropic
# BLOGAGENT_USE_LLM_EDITOR=true
# ANTHROPIC_API_KEY=your_key_here

# ---------------------------------------------------------------------------
# AgentPulse runtime tracing (optional)
# ---------------------------------------------------------------------------

# Set AGENTPULSE_ENABLED=true and supply URL + ingest key to enable telemetry.
# Telemetry is always best-effort — BlogAgent never fails if AgentPulse is
# unavailable or misconfigured.
AGENTPULSE_ENABLED=false
AGENTPULSE_URL=
AGENTPULSE_INGEST_KEY=
AGENTPULSE_PROJECT_ID=blog-agent
AGENTPULSE_PROJECT_NAME="Blog Agent"
AGENTPULSE_WORKFLOW_ID=blog-agent-v1
AGENTPULSE_DEBUG=false