Image Generation
Control the behavior of the/image command and manage usage limits. For a complete guide, see multimedia generation.
| Variable | Description | Default |
|---|---|---|
IMAGE_GENERATIONS_LIMIT | A monthly limit on the number of images a user can generate. Set to 0 for unlimited. This helps manage API costs. | 0 |
IMAGE_GENERATIONS_WHITELIST | A comma-separated list of users (usernames or IDs) who are exempt from the image generation limit. | None |
IMAGE_N_CHOICES | The number of image variations to generate per request. | 1 |
IMAGE_QUALITY | The quality of the generated image. Options like standard or hd can affect cost and detail. | standard |
IMAGE_SIZE | The default dimensions for the generated image (e.g., 1024x1024). | 1024x1024 |
IMAGE_ASPECT_RATIO | The default aspect ratio (e.g., 16:9, 1:1). This provides a more intuitive way to control image shape than specific dimensions. | 16:9 |
Context & Sampling
Fine-tune the AI’s responses by controlling context length and sampling parameters. These settings directly impact the creativity, coherence, and cost of the model’s output.| Variable | Description | Default |
|---|---|---|
MAX_HISTORY_TOKENS | The maximum number of tokens from the conversation history to send with each new request. A lower value saves costs but may cause the bot to “forget” earlier parts of the conversation. | 64000 |
MAX_TOKENS | The maximum number of tokens the model is allowed to generate in its response. Prevents overly long or expensive replies. | 32000 |
TEMPERATURE | Controls the randomness of the output. A value closer to 0.0 makes the model more deterministic and focused, while a value closer to 2.0 makes it more creative and unpredictable. | 1.0 |
FREQUENCY_PENALTY | A value that penalizes new tokens based on their existing frequency in the text so far, discouraging the model from repeating the same lines verbatim. | 0.0 |
PRESENCE_PENALTY | A value that penalizes new tokens based on whether they appear in the text so far, encouraging the model to introduce new topics. | 0.0 |
MAX_CONVERSATION_AGE_MINUTES | The maximum time in minutes that a conversation context is considered “active.” Older conversations will be pruned to manage memory. | 360 |
Model Context Protocol (MCP)
MCP allows Chibi to integrate with external tools and services, giving it powerful new capabilities. Learn more about Agent Mode and MCP integration.| Variable | Description | Default |
|---|---|---|
ENABLE_MCP_SSE | Set to True to enable the Server-Sent Events (SSE) based MCP, allowing for real-time, asynchronous tool communication. | True |
ENABLE_MCP_STDIO | Set to True to enable the Standard I/O (stdio) based MCP, for integrating with local command-line tools. | False |
Heartbeat (Health Monitoring)
Configure a “heartbeat” to send periodic pings to an external monitoring service. This is a simple way to verify that your bot is alive and running.| Variable | Description | Default |
|---|---|---|
HEARTBEAT_URL | The endpoint URL of your monitoring service (e.g., Healthchecks.io, Uptime Kuma). | None |
HEARTBEAT_FREQUENCY_CALL | The interval in seconds between each heartbeat ping. | 30 |
HEARTBEAT_RETRY_CALLS | The number of times to retry a failed ping before considering the connection lost. | 3 |
HEARTBEAT_PROXY | A proxy to use for sending heartbeat requests. | None |
Next Steps
- Enable Agent Mode: Explore the Agent Mode introduction for advanced automation capabilities.
- Configure multimedia: Set up image and music generation.
- Review core settings: Check the core settings for essential configuration options.
- Need help? Visit the troubleshooting guide or FAQ.