Configuration reference
Defaults below come from the source at 898dfbe. Configuration is split across classes; there is no single loader that maps every SOVEREIGN_* variable into engine options.
EngineConfig
Defined in src/sovereign.py.
| Field | Default | Meaning |
|---|---|---|
allowed_roots |
[Path.cwd()] |
Roots passed to the constructed PathJail |
ledger_path |
Path("./sovereign.worm") |
Evidence ledger location |
continuity_dir |
Path.home() / ".sovereign" / "continuity" |
Continuity base directory |
max_steps |
15 |
Value passed to ReActConfig |
enable_shadow |
True |
Construct a shadow agent |
enable_ipc |
True |
Construct the native-tool router |
agent_id |
"sovereign_main" |
Agent identifier |
These are constructor fields. The class does not automatically read SOVEREIGN_MAX_STEPS, SOVEREIGN_ALLOWED_ROOTS, or the other environment overrides listed in the older guide. Constructing a PathJail does not automatically apply it to every registered handler.
ReActConfig
Defined in react.py.
| Field | Default |
|---|---|
max_steps |
10 |
reflection_on_error |
True |
log_to_worm |
True |
require_approval_for_risky |
True |
continuity_base_dir |
Path.home() / ".sovereign" / "continuity" |
enable_continuity |
True |
There are no timeout_ms, model_provider, temperature, or top_p fields on this dataclass. The agent receives model, tool_registry, optional approval_engine, optional worm_ledger, config, and agent_id. Its run signature is run(task: Task, initial_context: str | None = None).
RoutingPipeline
The pipeline constructor accepts experts, top_k=2, optional routing_nodes, optional nand_conflicts, merge_strategy="weighted_concat", and expert_timeout_ms=30000. See Routing for a runnable callback example.
Provider and bridge configuration
| Consumer | Setting | Source behavior |
|---|---|---|
| BedrockBackend | model_id, region constructor arguments |
Defaults to the model listed in the root README and us-east-1; uses boto3 credentials |
| OllamaProvider | base_url, default_model, api_key |
Explicit URL/key or OLLAMA_BASE_URL / OLLAMA_API_KEY; default model llama3.2 |
| MultiProvider | OPENROUTER_API_KEY or key manager |
Adds OpenRouter when configured, then Ollama fallback |
| HTTPBridge | host, port |
Defaults to 127.0.0.1:19000 |
| Electron tool broker | SOVEREIGN_ENGINE_BRIDGE_URL |
Defaults to http://127.0.0.1:19000 |
| Electron renderer | SHADOW_DESKTOP_DEV_URL |
Optional development renderer URL |
The HTTP module entrypoint constructs HTTPBridge() directly and does not parse --host or --port. To change those values, instantiate the class in your own launcher. Neither an .env file nor the names in .env.example establish that a particular consumer reads a value.
See bridge contracts and known integration gaps before using the orchestration paths.