ENV_VARS.md

AFK Python SDK Environment Variables (v1.0.0)

This reference documents environment defaults. Runtime configuration APIs remain primary.

LLM Defaults

Variable	Default	Description
AFK_LLM_PROVIDER	litellm	Default provider id (openai, litellm, anthropic_agent)
AFK_LLM_MODEL	gpt-4.1-mini	Default model
AFK_EMBED_MODEL	(none)	Embedding model
AFK_LLM_API_BASE_URL	(none)	Provider API base
AFK_LLM_API_KEY	(none)	Provider API key
AFK_LLM_TIMEOUT_S	30	Request timeout seconds
AFK_LLM_STREAM_IDLE_TIMEOUT_S	45	Stream idle timeout seconds
AFK_LLM_MAX_RETRIES	3	Retry attempts
AFK_LLM_BACKOFF_BASE_S	0.5	Retry backoff base
AFK_LLM_BACKOFF_JITTER_S	0.15	Retry jitter
AFK_LLM_JSON_MAX_RETRIES	2	Structured output repair attempts
AFK_LLM_MAX_INPUT_CHARS	200000	Input truncation ceiling

Memory

Variable	Default	Description
AFK_MEMORY_BACKEND	sqlite	inmemory, sqlite, redis, postgres
AFK_SQLITE_PATH	afk_memory.sqlite3	SQLite file path
AFK_REDIS_URL	(none)	Redis URL
AFK_PG_DSN	(none)	PostgreSQL DSN

Queue

Variable	Default	Description
AFK_QUEUE_BACKEND	inmemory	inmemory, redis
AFK_QUEUE_RETRY_BACKOFF_BASE_S	0.5	Retry base delay
AFK_QUEUE_RETRY_BACKOFF_MAX_S	30	Retry max delay
AFK_QUEUE_RETRY_BACKOFF_JITTER_S	0.2	Retry jitter

Execution contracts are configured in code via TaskWorker(..., execution_contracts=...).

Prompts

Variable	Default	Description
AFK_AGENT_PROMPTS_DIR	.agents/prompt	Prompt root directory

A2A

No default environment variables are required. Configure A2A host/auth in code for explicit security posture.