Quantasia Configuration File Documentation

TOMLYN file format settings for the Quantasia AI Assistant Door
Quantasia uses a TOML‑based configuration file to control its behavior, appearance, sysop permissions, and integration with external AI services. This document explains every available setting, its purpose, and recommended usage.

IMPORTANT: The settings in each section MUST stay in their original order or the Tomlyn API cannot process the file correctly. You can have multiple [[Providers]] and [[Services]] 
sections, but each settings in those section must maintain their original order as they are in the example config.toml file.

THE FOLLOWING GENERAL SETTINGS ARE FOUND AT THE TOP OF THE config.toml FILE.

api_timeout
Type: integer
Default: 90
Defines how many seconds Quantasia will wait for an AI API response before timing out.
Increase this value if you use slower models or have a high‑latency network connection.

language
Type: string
Default: en
Specifies the language code sent to the geocoding API.
This determines the language used when returning location‑based results.

email_address
Type: string
A valid email address used in API calls to satisfy User‑Agent requirements.
Some services require this for identification and rate‑limit tracking.

bbs_name
Type: string
The name of your BBS.
Displayed inside the door and used when generating your registration key.

sysop_level
Type: integer
Default: 99
Minimum access level required to unlock sysop‑only features.
This value must match the level passed through door32.sys by your BBS.

sysop_editor
Type: boolean
Default: true
Enables the sysop editor, allowing you to add, remove, or modify AI services (LLMs) from within the door.
Set to false to lock down service management.

allow_import_dupes
Type: boolean
Default: true
Allows duplicate service definitions when importing new LLM configurations.
Useful during testing or when experimenting with multiple variants of the same model.

intro
Type: multi‑line string
Defines the introduction text shown when the door starts.
Supports Quantasia color tokens and {cr} for line breaks.
Example tokens:
- {white}
- {red}
- {yellow}
- {black}
- {darkred}
- {cr} (carriage return / new line)
This is ideal for disclaimers, greetings, or custom branding. Use triple """ double quotes if your intro takes up more than one line.

enable_sixel
Type: boolean
Default: true
Enables Sixel graphics output for terminals that support it (e.g., SyncTERM, IcyTerm).
Disable if users report display issues or if your board caters to text‑only clients.

enable_subtitles
Type: boolean
Adds a subtitle line beneath the “I’m Thinking…” spinner.
Useful for giving users more context during long AI operations.

enable_humor
Type: boolean
Adds humorous or playful subtitles to the “I’m Thinking…” spinner.
Great for casual boards; optional for serious or professional themes.

scrollback_buffer_lines
Type: integer
Default: 1000
Number of lines stored in the scrollback buffer. 500 - 1000 recommended.
Lower this value

debug_mode = true
Type: Boolean
Default: false
Use this to display debug information while setting up and testing the door, set to false for production use

reg_key
Type: string
Your Quantasia registration key.
This unlocks all features.
Registration key that unlocks all features, please go to firesidebbs.com to get yours. Ensure the bbs_name matches the name used when generating the key.

