Configuration
Everything lives on your machine. This page is the map of the state directory and the environment variables that override it.
Local data#
| What | Where |
|---|---|
| Credentials | ~/.wednesday/.env |
| Teams (crews) | ~/.wednesday/state/crews.json |
| Task history | ~/.wednesday/state/tasks.json |
| Event log | ~/.wednesday/state/events.jsonl |
| Your skills | ~/.wednesday/skills/ |
| MCP servers you attach | ~/.wednesday/state/mcp.json |
Deleting ~/.wednesday/ removes the local profile. There is no copy on our side.
State and path overrides#
| Variable | Effect |
|---|---|
WEDNESDAY_STATE_HOME | Moves the state directory. |
HERMES_TASKS_PATH | Selects the task store file. |
FACTORY_EVENTS_PATH | Selects the event log file. |
WEDNESDAY_SKILLS_HOME | Moves the skills directory. |
Model and provider variables#
| Variable | Effect |
|---|---|
OPENROUTER_API_KEY | OpenRouter key. |
NVIDIA_API_KEY | NVIDIA NIM key. |
LOCAL_LLM_BASE_URL | Base URL for a local OpenAI-compatible server. |
LOCAL_LLM_MODEL | The single model when no pool or crew slots are set. |
FACTORY_MODEL_POOL | Comma-separated model ids, or id@baseURL. |
FACTORY_RELAY | Set to 1 to turn on team-up and capability routing. |
FACTORY_LLM_PROVIDER | The route provider, for example local. |
FACTORY_CREW_<SEAT>_MODEL | The model for one seat (hyphens become underscores). |
FACTORY_CREW_<SEAT>_BASE_URL | The endpoint for one seat. |
FACTORY_MOA | Set to 1 to send a turn to several teammates and aggregate. |
FACTORY_MOA_PROPOSERS | Comma-separated seats or models for the mixture. |
FACTORY_MOA_AGGREGATOR | Who synthesises the final answer. |
FACTORY_MAX_REPAIR_ATTEMPTS | The repair cap. |
FACTORY_BUDGET_TOKENS | Token ceiling for one run. |
FACTORY_BUDGET_USD | USD ceiling for one run. |
FACTORY_PRICE_<MODEL> | USD per million tokens: input,output. |
The .env file#
Keys and routes live in ~/.wednesday/.env, never in the repository. The file is read by the engine, and secret values are not printed in receipts or status output.
~/.wednesday/.env
OPENROUTER_API_KEY=...
LOCAL_LLM_BASE_URL=http://127.0.0.1:11434/v1
LOCAL_LLM_MODEL=qwen2.5-coder-3b-instruct
FACTORY_PRICE_QWEN_QWEN3_CODER=0.30,1.20
Do not commit this file. Do not paste a key into a task record or a chat message; the scan is a shape matcher, not a guarantee.