bridging-bot/.env.example at main · Plurality-Institute/bridging-bot · 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
# Database (required)
# Local: use docker-compose postgres
POSTGRES_USER=your_db_user
POSTGRES_PASSWORD=your_db_password
POSTGRES_DB=your_db_name
DATABASE_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}
# Remote: use a hosted database (e.g. Neon, Supabase, RDS)
# DATABASE_URL=postgresql://user:password@host/dbname?sslmode=require

# Prefect (required)
# Local: use docker-compose prefect server
PREFECT_API_URL=http://prefect-server:4200/api
# Remote: use Prefect Cloud
# PREFECT_API_KEY=your_prefect_cloud_api_key
# PREFECT_API_URL=https://api.prefect.cloud/api/accounts/{account_id}/workspaces/{workspace_id}
# PREFECT_ACCOUNT_ID=your_prefect_account_id
# PREFECT_WORKSPACE_ID=your_prefect_workspace_id

# Reddit API credentials (required — at minimum one set)
REDDIT_CLIENT_ID_1=your_reddit_client_id
REDDIT_CLIENT_SECRET_1=your_reddit_client_secret
REDDIT_USER_AGENT_1=your_reddit_user_agent
# Additional credential sets: REDDIT_CLIENT_ID_2, REDDIT_CLIENT_SECRET_2, etc.
REDDIT_CREDENTIAL_MODE=random  # random or db_lock
REDDIT_USERNAME=  # username for script-type Reddit apps (password auth)
REDDIT_PASSWORD=  # password for script-type Reddit apps
REDDIT_SCRIPT_APP_IDS=  # comma-separated client IDs that support password auth
REDDIT_BOT_USERNAME=  # username the bot posts under (used for reconciliation)

# Auto-posting
AUTO_POST_ENABLED=false  # set to true to auto-post interventions to Reddit
AUTO_POST_SUBREDDITS=  # comma-separated allowlist (empty = all subreddits when enabled)

# LLM (required for classification/intervention)
OPENAI_API_KEY=your_openai_api_key

# Braintrust (required for classification/intervention)
BRAINTRUST_API_KEY=your_braintrust_api_key
BRAINTRUST_PROJECT_NAME=your_braintrust_project_name
BRAINTRUST_CLASSIFICATION_PROMPT_SLUG=your_classification_prompt_slug
BRAINTRUST_CLASSIFICATION_PROMPT_VERSION=
BRAINTRUST_THREAD_CLASSIFICATION_PROMPT_SLUG=your_thread_classification_prompt_slug
BRAINTRUST_THREAD_CLASSIFICATION_PROMPT_VERSION=
BRAINTRUST_THREAD_SELECTION_PROMPT_SLUG=your_thread_selection_prompt_slug
BRAINTRUST_THREAD_SELECTION_PROMPT_VERSION=
BRAINTRUST_INTERVENTION_PROMPT_SLUG=your_intervention_prompt_slug
BRAINTRUST_INTERVENTION_PROMPT_VERSION=
MIN_THREAD_MESSAGES=3

# Google Sheets (optional — for sheet-based workflows)
GOOGLE_SHEETS_CREDS_PATH=your_google_sheets_creds_path
GOOGLE_SHEETS_ID=your_google_sheets_id
GOOGLE_SHEETS_RANGE=Sample Data!A1:G40

# Perspective API (required — for toxicity scoring in the pipeline)
PERSPECTIVE_API_KEY=your_perspective_api_key

# Discord notifications (optional)
DISCORD_WEBHOOK_URL=
INTERVENTION_DISCORD_WEBHOOK_URL=

# Webapp (optional)
SESSION_SECRET_KEY=dev-secret-change-in-production

# Logging
LOG_LEVEL=INFO