Configuration

Configuration

Config is stored at ~/.df-storyteller/config.toml.

Full Config Reference

[paths]
df_install = "C:\\path\\to\\Dwarf Fortress"
gamelog = "C:\\path\\to\\Dwarf Fortress\\gamelog.txt"
event_dir = "C:\\path\\to\\Dwarf Fortress\\storyteller_events"
legends_xml = ""  # Auto-detected from df_install if empty
output_dir = "~/.df-storyteller/stories"  # Must be absolute path

[llm]
provider = "ollama"  # claude | openai | ollama
model = ""
api_key = ""
api_key_env = ""  # Fallback to environment variable
max_tokens = 4096
temperature = 0.8

[llm.ollama]
base_url = "http://localhost:11434"
model = "llama3"

[story]
chronicle_auto_generate = false
chronicle_trigger = "season"  # season | manual
narrative_style = "dramatic"  # dramatic | factual | humorous
chronicle_max_tokens = 4096
biography_max_tokens = 1024
saga_max_tokens = 4096
chat_summary_max_tokens = 2048
gazette_max_tokens = 4096
quest_generation_max_tokens = 2048
quest_narrative_max_tokens = 1024

[watch]
# Event monitoring settings

Key Notes

• output_dir must be an absolute path (relative paths cause data loss depending on CWD)
• legends_xml is auto-detected from the DF install directory if left empty — picks the most recent legends file
• API keys are stored in config file with fallback to environment variables
• Old configs without new fields get Pydantic defaults silently
• All token settings are configurable via the Settings page in the web UI