Ex tenebris surgit lumen posteris

A local-first personal dashboard built on the Metis Toolbox — single-purpose modules following the Anti-Legion principle: one module, one job. No database, no server, no cloud.

Felhaven renders the toolbox in panels. Pythia answers questions in the home chat, and Calliope can read her answers aloud. (An earlier voice-input assistant, "Metis", was retired — the toolbox is typed-in, optionally spoken-back.)

• SETUP.md — installing on a fresh machine
• CONVENTIONS.md — module contracts, patterns, and the decisions log
• CHANGELOG.md — dated history
• metis_toolbox/README_PANTHEON/ — one page per module

Three pieces of shared infrastructure tie ~30 independent modules together. Each module knows about these; none know about each other.

Same module, two entry points, opposite failure policy — that split is the core of the design. Details in CONVENTIONS.md §2 and §6.

Code lives in three places: metis_toolbox/ (the app root — entry point, shared infrastructure, config), metis_toolbox/tools/ (headless logic), and metis_toolbox/panels/ (Tk display surfaces).

One sidebar row per view; picking a row swaps the content area. UI names are gothic-imperial, the code keeps the deity module names.

Two brain tools have no view — Callimachus (web search) and Herodotus (a local Markdown archive) are reached only through Pythia's chat.

Auto-DJ has no view of its own either, and is not a tool at all. With the toggle on, Awen (awen.py) picks the next song when one ends, plays it through Morpheus and introduces it aloud — the one job in the stack that acts without being asked. Euterpe (tools/euterpe.py) is the list of songs you chose, which it copies the taste of; that list is drawn, as Vox Array's TUNES tab, and you edit it by hand. The DJ reads it and never adds to it — its own picks are remembered only for as long as the app is running, just far enough to stop it repeating itself. Neither module is reachable by the model: a job the model could start would be the model scheduling its own unprompted work.

Double-click metis_toolbox/Felhaven.bat, or:

cd metis/metis_toolbox
python felhaven.py

The .bat launches the Sphynx boot gate first, which spawns felhaven.py on a correct PIN. Running felhaven.py directly skips the gate.

Narration has no separate process: click the speak control under any answer, or light the narration lamp in the home view's command row to have every answer read aloud as it arrives. Off by default.

Both API keys are optional; every other network call uses a keyless public endpoint. A locked vault, a missing key, or a missing binary degrades to a placeholder or a clean error — never a crash.

Logs rotate into metis_toolbox/logs/. The |-delimited line format is load-bearing: Emanon tails these files and parses them with a plain str.split(" | ") — no regex — so the delimiter and column order cannot change unilaterally. Full rules in CONVENTIONS.md §5.

The public snapshot of Felhaven is released under the MIT License — see LICENSE.md. Use, copy, modify, and redistribute freely; just keep the copyright notice and license text with it. No warranty.