PraisonAI/.env.example at main · MervinPraison/PraisonAI · 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
# PraisonAI Environment Variables
# Copy this file to .env and update with your actual values

# === Required ===
OPENAI_API_KEY=sk-...          # OpenAI key for LLM calls. Get yours at https://platform.openai.com

# === Required for Claw web-search tool ===
TAVILY_API_KEY=tvly-...        # Get yours at https://app.tavily.com (free tier available)

# === Optional: Claw dashboard security ===
PRAISONAI_ALLOW_LOCAL_TOOLS=0  # Set to 1 to enable local shell tools (security risk)

# === Optional: Alternative LLM Providers ===
ANTHROPIC_API_KEY=sk-ant-...   # Anthropic Claude models
GOOGLE_API_KEY=...             # Google Gemini models
GROQ_API_KEY=gsk_...           # Groq (fast inference)
COHERE_API_KEY=...             # Cohere models
AZURE_OPENAI_API_KEY=...       # Azure OpenAI
AZURE_OPENAI_ENDPOINT=...      # Azure OpenAI endpoint

# === Optional: Memory backends ===
MEM0_API_KEY=...               # Mem0 memory service
REDIS_URL=redis://localhost:6379  # Redis for state management

# === Optional: Observability ===
LANGFUSE_SECRET_KEY=sk-lf-...  # Langfuse tracing
LANGFUSE_PUBLIC_KEY=pk-lf-...  # Langfuse public key

# === Optional: Bot platforms ===
TELEGRAM_BOT_TOKEN=...         # Telegram bot token
DISCORD_BOT_TOKEN=...          # Discord bot token
SLACK_BOT_TOKEN=xoxb-...       # Slack bot token
SLACK_APP_TOKEN=xapp-...       # Slack app token
WHATSAPP_ACCESS_TOKEN=...      # WhatsApp bot access token
WHATSAPP_PHONE_NUMBER_ID=...   # WhatsApp phone number ID

# === Optional: Database ===
DATABASE_URL=sqlite:///~/.praison/database.sqlite  # Database connection string

# === Optional: Tool Security ===
# ALLOWED_TOOLS=search,send_message       # Whitelist specific tools to prevent name collisions
                                        # Useful in multi-environment setups with overlapping tool names
                                        # Leave unset to use all tools (with collision warnings)
                                        # Do NOT set to empty string: that's treated as configuration error
                                        # In CI, unknown tool names in the whitelist cause strict startup failure
# HERMES_ONLY_TOOLS=search,send_message  # (Deprecated) Backward compatibility alias for ALLOWED_TOOLS

# === Optional: Development ===
LOGLEVEL=INFO                  # Logging level (DEBUG, INFO, WARNING, ERROR)
CHAINLIT_AUTH_SECRET=...       # Chainlit authentication secret
DEBUG=false                    # Enable debug mode