PerplexityAgent/.env.example at main · CryptoJones/PerplexityAgent · 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
# Copy to .env and fill in. NEVER commit your real .env.
# Get a key at https://www.perplexity.ai/settings/api

# Required: your Perplexity API key (kept server-side, never returned in tool output).
PERPLEXITY_API_KEY=pplx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# --- Optional tuning (defaults shown) ---

# Perplexity API base URL.
# PERPLEXITY_BASE_URL=https://api.perplexity.ai

# Per-request HTTP timeout (seconds).
# PERPLEXITY_TIMEOUT=60

# Max bytes accepted from a single API response (DoS guard).
# PERPLEXITY_MAX_RESPONSE_BYTES=5242880

# Max retries for transient (5xx / network) failures, with jittered backoff.
# PERPLEXITY_MAX_RETRIES=3

# Optional finance-response cache TTL in seconds (0 disables it). Keep this
# small because quotes and market data can change rapidly; maximum is 300.
# PERPLEXITY_FINANCE_CACHE_TTL_S=0

# Token-bucket rate limit: sustained requests/minute and burst size.
# PERPLEXITY_RATE_PER_MINUTE=60
# PERPLEXITY_RATE_BURST=10

# Optional path for the JSON audit log. If unset, audit events go to stderr only.
# PERPLEXITY_AUDIT_LOG_PATH=/var/log/perplexity-agent/audit.log

# --- Optional hardened HTTP transport (off by default; stdio is the default) ---
# Only used when launched with `--transport http`.
# A bearer token clients must present (REQUIRED for HTTP mode). Keep it secret.
# PERPLEXITY_HTTP_AUTH_TOKEN=
# PERPLEXITY_HTTP_HOST=127.0.0.1
# PERPLEXITY_HTTP_PORT=8080

# --- Optional interactive TUI (`perplexity-agent tui`; needs the `tui` extra) ---
# User-Agent the page fetcher sends when you `/open` a URL.
# PERPLEXITY_FETCH_USER_AGENT=PerplexityAgent-TUI/0.2 (+https://codeberg.org/CryptoJones/PerplexityAgent)
# Allow fetching private/loopback/link-local addresses. Leave false (SSRF guard).
# PERPLEXITY_FETCH_ALLOW_PRIVATE=false
# Where the TUI and MCP server keep local sqlite state (history, tabs, spaces,
# and session-scoped stored Agent responses). Defaults to an XDG data dir.
# PERPLEXITY_STORE_PATH=
# Per-Space retention caps for the local store. Tabs default to a 50-tab recent
# cache; conversation history defaults to unbounded (nothing is ever deleted).
# Set to a positive integer to keep only the N most-recent rows per Space, or
# leave blank to keep everything.
# PERPLEXITY_MAX_TABS_PER_SPACE=50
# PERPLEXITY_MAX_HISTORY_PER_SPACE=
# Stored Agent response snapshots retained per MCP client session.
# PERPLEXITY_MAX_RESPONSES_PER_SESSION=100