Environment variables

The bot reads all of its configuration from environment variables, typically set in a .env file or passed to the container. See Setup for where each value comes from, and AI Providers for the AI_PROVIDER_* settings in depth.

Slack

Variable	Required	Default	Description
SLACK_BOT_TOKEN	Yes	—	Bot User OAuth token (xoxb-…).
SLACK_APP_TOKEN	Yes	—	App-level token with the connections:write scope (xapp-…), used for Socket Mode.
SLACK_BOT_DEBUG_MODE	No	false	Enable verbose debug logging.

UIGraph

Variable	Required	Description
UIGRAPH_API_URL	Yes	Base URL of your UIGraph API.
UIGRAPH_MCP_URL	Yes	Base URL of your UIGraph MCP server, where the bot reads your architecture data.
UIGRAPH_TOKEN	Yes	Service account API key / access token for the organization the bot answers for (uig_…).

AI model

See AI Providers for the supported providers and examples.

Variable	Required	Default	Description
AI_PROVIDER_API_KEY	Yes	—	API key for your chosen model provider.
AI_PROVIDER_MODEL	Yes	—	Model to use, e.g. gpt-4o or claude-sonnet-5.
AI_PROVIDER_NPM	No	@ai-sdk/openai-compatible	Which provider to use.
AI_PROVIDER_API_URL	No*	—	Endpoint URL. Required when using the default @ai-sdk/openai-compatible provider.
AI_PROVIDER_OPTIONS	No	—	Extra provider settings as a single line of JSON.

* Required only for the default OpenAI-compatible provider.

Behaviour

Variable	Required	Default	Description
LLM_MAX_STEP	No	100	The most tool-calling steps the bot may take while answering one question.
LLM_MESSAGES_LIMIT	No	25	The most recent messages of a thread the bot reads for context.
LLM_ATTACHMENT_IMAGE	No	false	Let the bot read image files shared with it.
LLM_ATTACHMENT_AUDIO	No	false	Let the bot read audio files shared with it.
LLM_ATTACHMENT_VIDEO	No	false	Let the bot read video files shared with it.
PORT	No	3000	Port the bot process binds to. Not used for incoming Slack traffic in Socket Mode.