All configuration lives in sundew.yaml at the project root.
Full reference
traps:
mcp_server: true # Enable MCP server trap
rest_api: true # Enable REST API trap
ai_discovery: true # Enable AI discovery endpoints
persona: auto # "auto" for random, or path to persona.yaml
llm:
provider: ollama # ollama | anthropic | openai | none
model: llama3 # Model name for the provider
base_url: null # Custom API base URL (optional)
api_key: null # API key -use env vars instead
temperature: 0.7 # Generation temperature
max_tokens: 2048 # Max tokens per generation
server:
host: 0.0.0.0 # Listen address
port: 8080 # Listen port
storage:
database: ./data/sundew.db # SQLite database path
log_file: ./data/events.jsonl # JSONL event log path
logging:
level: info # debug | info | warning | error
output: stdout # stdout | file path
Traps
Enable or disable individual trap surfaces:
traps:
mcp_server: true
rest_api: true
ai_discovery: true
Persona
The persona field controls identity generation:
| Value | Behavior |
|---|
auto | Generate a random persona on first run |
| File path | Load a custom persona from YAML |
# Random persona
persona: auto
# Custom persona
persona: ./my-persona.yaml
LLM providers
Sundew uses an LLM to generate response templates at deploy time. Supported providers:
Ollama (local)
Anthropic
OpenAI
None
llm:
provider: ollama
model: llama3
llm:
provider: anthropic
model: claude-sonnet-4-5-20250929
ANTHROPIC_API_KEY in your environment.llm:
provider: openai
model: gpt-4o
OPENAI_API_KEY in your environment.Uses pre-built persona packs only. No LLM required. LLM calls happen only at deploy time during persona generation. There are zero LLM calls during runtime operation -all responses are served from the pre-generated template cache.
Server
server:
host: 0.0.0.0
port: 8080
sundew serve --host 127.0.0.1 --port 9090
Storage
storage:
database: ./data/sundew.db
log_file: ./data/events.jsonl
- SQLite -structured storage for queries and session analysis
- JSONL -append-only streaming log with automatic rotation (100 MB default, 5 backups)
Environment variables
Sensitive values should be set as environment variables rather than in config:
| Variable | Purpose |
|---|
ANTHROPIC_API_KEY | API key for Anthropic LLM provider |
OPENAI_API_KEY | API key for OpenAI LLM provider |
SUNDEW_LOG_LEVEL | Override logging level |
