Skip to content

Configuration Basics

tusk install creates and manages your initial runtime configuration.

Runtime Path

By default, TuskBot stores runtime data in ~/.tuskbot.

You can override this with:

  • TUSK_RUNTIME_PATH

What Is Stored There

  • .env (runtime configuration)
  • tuskbot.db (SQLite database)
  • config/mcp_config.json (MCP server config)
  • models/ (local embedding models)
  • prompt/ (system and profile prompt files)

Common Variables

VariablePurpose
TUSK_TELEGRAM_TOKENTelegram bot token
TUSK_TELEGRAM_OWNER_IDAllowed Telegram user ID
TUSK_CHAT_CHANNELActive chat transport (telegram)
TUSK_MAIN_MODELPrimary LLM model (provider/model)
TUSK_EMBEDDING_MODELEmbedding model filename
TUSK_RUNTIME_PATHRuntime data directory

Full Configuration Reference

Released under the MIT License