sovos-router

Routing + fleet + cluster orchestration for SOVOS. Absorbed 2026-08-11 from top-level Python scripts that were the operational spine of the substrate before the monorepo absorbed it.

Files

File	Purpose	LOC
`sov4_router.py`	Per-suite routing across the OWEM cluster; routes every request to the cheapest/fastest OWEM that excels at the suite	1195
`sov_orchestrator.py`	SOV-Space unified orchestrator: wires routers, pipelines (23 scripts), training data, models, stigmergy	242
`sov_swarm.py`	GPU cluster auto-scaler for sovereign end-user models (tier-0 qwen2.5:0.5b → tier-3 lora-merged)	255
`master_hives.py`	Three master OWEM groups (CSOAI / DEFONEOS / DEFENCE / MEOK) as monotonic fractal clusters	179
`owem_cluster.py`	The OWEM cluster config + routing keys + heartbeat	272
`router_control.py`	Confound-aware router eval (separates the router from the wrapper; Δ+9.42 n=186 result)	152
`fleet_dashboard.py`	Fleet state observability view	118
`fleet_monitor.py`	Heartbeat-based fleet liveness check	43
`fleet_power.py`	Computes effective compute power across the heterogeneous fleet	126

Provenance

All 9 scripts are absorbed verbatim from the top-level of the repo into SOVOS/packages/sovos-router/src/sovos_router/. The package re-exports them via __init__.py.

Use

from sovos_router import sov4_router, sov_orchestrator
sov4_router.run()
sov_orchestrator.wire_all()  # wires routers, pipelines, models

Or run the scripts standalone:

python3 SOVOS/packages/sovos-router/src/sovos_router/sov4_router.py --help
python3 SOVOS/packages/sovos-router/src/sovos_router/fleet_monitor.py

Cross-link

The orchestrator's wiring of sov_router → pipelines feeds into sovos-arena (13-axis measurement) + sovos-chain (Fisher-Rao compliance chain).
fleet_dashboard.py reads from SOVOS/data/hive/ operational JSON (the absorbed forest/ data).
master_hives.py knows about CSOAI / DEFONEOS / DEFENCE / MEOK as the three top-level hive brands.

This is the spine. Each routing decision SOVOS makes passes through this package.

Metadata

Release files for sovos-router 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sovos-router 0.1.0
File	Size	Uploaded
sovos_router-0.1.0.tar.gz	40.7 kB	Aug 24, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for sovos-router 0.1.0
File	Interpreter	ABI	Platform	Reset
sovos_router-0.1.0-py3-none-any.whl 43.8 kB Aug 24, 2026	Python 3	none	any	Details

Total release size: 84.5 kB

Release files / sovos_router-0.1.0.tar.gz

Download URL	sovos_router-0.1.0.tar.gz
Size	40.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`9e47b30852cd6324745b45147f1a6a0e991b884875cc60ff51eb2a2c01b40ded`
BLAKE2b-256 checksum How to use checksums	`d10101e4e1c815ed4a4f41c4ea6f7e4e9dfc1a292f503128296590fa03679ada`
Upload date	Aug 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.15`

Release files / sovos_router-0.1.0-py3-none-any.whl

Download URL	sovos_router-0.1.0-py3-none-any.whl
Size	43.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ea0b831efa0def80b146416924d3bf0aba94d1467a8f87be12fb71f9fc77338e`
BLAKE2b-256 checksum How to use checksums	`90d7d981f0235370070c40b63e1b71a03d087152989d697f022b2fe04b93d1c8`
Upload date	Aug 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.15`

Release history Release notifications | RSS feed

This release

0.1.0 This release

Aug 24, 2026 2 release files

sovos-router 0.1.0