springtale.toml.example

# Springtale Configuration
#
# Copy this file to springtale.toml and adjust as needed.
# Environment variables override file values (SPRINGTALE_ prefix).
# Example: SPRINGTALE_API_BIND=0.0.0.0:9090

[store]
# Path to the SQLite database file.
# Default: ~/.local/share/springtale/springtale.db
# path = "/home/user/.local/share/springtale/springtale.db"

[crypto]
# Path to the encrypted vault file (contains identity keypair).
# Default: ~/.local/share/springtale/vault.bin
# vault_path = "/home/user/.local/share/springtale/vault.bin"

[transport]
# Path to the Unix domain socket for local transport.
# Default: ~/.local/share/springtale/springtale.sock
# socket_path = "/home/user/.local/share/springtale/springtale.sock"

[api]
# Bind address for the management API.
# Default: 127.0.0.1:8080
# WARNING: binding to 0.0.0.0 exposes the API to the network.
bind = "127.0.0.1:8080"

# Maximum requests per second (rate limiting).
# Default: 100
rate_limit_per_sec = 100

# Plan §1.15 G — utterance def overrides. Keys are utterance names
# (firing, working, listening, idle, failed, down, claimed, yield, helping,
# rally, cascade). A block replaces that one def, so every field is
# required; omitted names keep the built-in def. `locales` maps a locale
# to its own glyph frames (the default `frames` stay the fallback).
#
# [cooperation.utterances.firing]
# carrier = "burst"          # speech | burst | thought | none
# shape = "triangle"         # triangle | circle | square
# tone = "alert"             # calm | alert | urgent
# frames = ["!"]
# locales = { ja = ["！"] }
# mirror_rtl = false
# label_key = "utter.firing"
# ttl_ticks = 2
# block_ticks = 3

# Connector configuration, for a headless install with no UI.
#
# One table per connector, under `connectors`, named by the connector's
# config key — the same key the panel and the onboarding wizard write.
# The daemon reads a table for every connector that is compiled in, so a
# connector added later needs no change to the daemon to be configurable
# here. `springtale-cli connector available` prints the config key of
# every connector in your build; the bare `[telegram]` form is still
# read, for config files that already use it.
#
# Credentials in this file sit on disk in plaintext: prefer the vault
# (configure through the app, or via the API) and keep this for values
# you are content to leave readable, or protect the file at 0600.
#
# [connectors.telegram]
# bot_token = "123456:ABC-DEF..."
# update_mode = "polling"        # polling | webhook
#
# [connectors.github]
# token = "ghp_..."
# webhook_secret = "..."