Skip to main content
Version: main

Configuration

Environment variable names are kept as code because they are used in commands and .env files.

Base settings​

VariableDefaultPurpose
GIGA_AGENT_PREFIX_API/agentInternal API prefix.
GIGA_AGENT_BASE_URLemptyPublic base URL.
GIGA_AGENT_FRONTEND_DIRemptyOverride UI directory.
GIGA_AGENT_UItrueServe the bundled UI.
GIGA_AGENT_RUNTIMElocalRuntime mode.
GIGA_AGENT_DATABASE_URLemptySQLAlchemy database URL; SQLite is used by default.
GIGA_AGENT_SECRET_KEYemptyAuthentication secret; set explicitly for shared servers.
GIGA_AGENT_LANGGRAPH_DEV_PORT9090Development server port.

Tools and providers​

GIGA_AGENT_TOOL_MAX_SIZE, GIGA_AGENT_ENABLE_THINK_TOOL, GIGA_AGENT_ENABLE_MULTI_TOOL_USE, GIGA_AGENT_SCRAPER_TOTAL_CONCURRENCY, and GIGA_AGENT_QDRANT_POOL_SIZE control tool output, service tools, scraping, and vector storage behavior.

Yandex OAuth application​

Yandex integrations (Mail, Calendar, Disk) connect via OAuth. An administrator registers an application once at oauth.yandex.ru and provides its credentials through environment variables:

VariablePurpose
YANDEX_OAUTH_CLIENT_IDThe application identifier; shared by Calendar and Disk.
YANDEX_OAUTH_CLIENT_SECRETThe application secret.
YANDEX_OAUTH_REDIRECT_URIAn optional explicit callback address; without it, the address is assembled from GIGA_AGENT_BASE_URL and the API prefix.
YANDEX_OAUTH_CLIENT_ID_YANDEX_MAILA separate application for Mail: Yandex requires its own application for the mail scope. Without this pair, Mail uses the shared credentials above.
YANDEX_OAUTH_CLIENT_SECRET_YANDEX_MAILThe mail application secret.

Until the variables are set, the OAuth connect button in the connectors catalog stays inactive, and the service cards explain how to enable the application. Integrations keep working on manual tokens.

Channels​

Channel bots (Telegram) are created in Settings → Channels: the channel type and the bot token are set in the form, with no environment variables involved. Contact access is granted manually — the bot stays silent until a contact is approved.

Per-user limits​

VariableDefaultPurpose
GIGA_AGENT_MAX_ACTIVE_THREADS_PER_USER5Maximum number of simultaneously active (busy) graph chats per user. 0 or less disables the limit.
GIGA_AGENT_LOCAL_JUPYTER_MAX_KERNELS_PER_USER5Maximum number of simultaneous local Jupyter kernels per user. When the limit is reached, the owner's least-recently-used kernel is evicted before a new one is created. 0 disables the limit.