Settings reference
Kaizen Manas reads 45 settings, mostly from a .env file. Each page gives the default, the allowed values, when to change it and what happens if the value is wrong.
In this section
GATEWAYWhich chat platform to run.DATA_DIRWhere state files live.MEMORY_ROOTWhere memory notes live.PROVIDERStartup provider. /setup saves a runtime choice that wins.AGNES_API_KEYKey for the Agnes provider.AGNES_BASE_URLAgnes endpoint.AGNES_MODELDefault Agnes model.GOOGLE_API_KEYKey for Google Gemini and for embeddings.GOOGLE_MODELDefault Google model.OPENAI_API_KEYKey for OpenAI.OPENAI_BASE_URLOpenAI-compatible endpoint.OPENAI_MODELDefault OpenAI model.OPENROUTER_API_KEYKey for OpenRouter.TELEGRAM_BOT_TOKENTelegram bot token.ALLOWED_TELEGRAM_IDSWho may talk to the Telegram bot.DISCORD_BOT_TOKENDiscord bot token.ALLOWED_DISCORD_IDSWho may talk to the Discord bot.REQUIRE_ALLOWLISTRefuse unlisted users.SANDBOX_MODEWhich sandbox runs Python.SANDBOX_TIMEOUTWall-clock limit for one run.SANDBOX_MAX_MEMORY_MBMemory cap for one run.SANDBOX_URLExternal sandbox address.SANDBOX_API_KEYBearer key for the external sandbox.AUTO_APPROVE_LOWRun LOW-risk code without buttons.MAX_TOOL_ROUNDSTool rounds per message. Clamped to 1 to 90.TOOL_PROGRESSShow tool progress lines.ENABLE_GITHUB_ISSUESLet the bot open sanitised crash reports as GitHub issues.GITHUB_PATGitHub token for git tools, issue reports and auto-update.GITHUB_ISSUES_REPOWhere crash reports go.NTFY_TOPICntfy topic for push messages.NTFY_URLntfy server.MCP_CONNECTORSField exists. MCP is not wired into the agent loop.LOG_LEVELLog detail.SHELL_ENABLEDTurn the host shell group on.SHELL_APPROVALWhich shell commands need a button.SHELL_MAX_SESSIONSOpen shell sessions.SHELL_MAX_RUNTIMELongest run of one command.SHELL_IDLE_TTLIdle time before a session closes.SHELL_DEFAULT_WAITHow long shell_exec waits before returning.SHELL_NPROC_BUDGETProcess budget for shell children.SHELL_PASS_ENVExtra environment names passed to the shell.AUTO_DEPLOYLet the supervisor watch the repo and update.DEPLOY_BRANCHBranch the supervisor follows.DEPLOY_POLL_SECONDSHow often to check for new commits.DEPLOY_LOG_KEEPPer-commit logs kept.
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.