raea reads each setting from the environment first, then from ~/.raea/env (or the file RAEA_ENV_FILE names):
one KEY=value per line, # for comments. Nothing has a hidden default host: a feature that needs a service says
which setting is missing.
raea makes no network requests: a remote URL not already in raea's cache, a model or sample library not yet installed, a composition's own fetch() or WebSocket, Bevy's http asset source and every raea gen step are refused with what wanted out. What's on disk keeps working
Two models make sound on your Mac, free, with no account. Each installs itself the first time a composition or a
command asks for it (a few minutes, once), or ahead of time with raea setup-audio.
Setting
What
RAEA_TOKENSYNTH
Where TokenSynth lives (default ~/.cache/raea-tokensynth, about 6 GB): an instrument described in words, one note at a time, for a Tone.js Sampler
RAEA_SAO
Where Stable Audio Open Small lives (default ~/.cache/raea-sao, about 2 GB, Core ML): foley and sound effects
RAEA_AUDIO_AUTOSETUP=0
Don't install on first use; a missing model's error names the command (tools/sao/setup.sh, tools/tokensynth/setup.sh)
From the command line, raea sao "PROMPT" -o hit.wav and raea tokensynth "TIMBRE" --notes C3,C4 -o notes/ make sounds through the same cache a composition's render uses, and raea sounds searches open sample
libraries (pianos, General MIDI instruments, orchestral and percussion samples, each with its licence).
Pages are drawn with Vello's own buffer sizes from the first frame, instead of raea's smaller ones (about 100 MB less GPU memory). A page past raea's sizes is found and drawn again at Vello's anyway, with a line on stderr, so this only saves that redraw
RAEA_PAGE_DRAWN_CHECK=0
Pages are drawn without checking that Vello drew them. For measuring what the check costs (about 2% in one test): a page past Vello's buffers then shows the frame before it again, or nothing
RAEA_NOT_APPLIED=0
A page's CSS is parsed without noting what stylo drops, so a render ends without its NOTE of what the page didn't apply (and its manifest's not_applied lists only loads that failed). For measuring what the note costs
RAEA_PANIC_FAULT=N
A panic while frame N draws, for checking what a failing render keeps (bench/frame-panic). The render then ends with an error naming the frame and the panic, and keeps the frames drawn before it