Skip to main content

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sovos_router-0.1.0.tar.gz (40.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sovos_router-0.1.0-py3-none-any.whl (43.8 kB view details)

Uploaded Python 3

File details

Details for the file sovos_router-0.1.0.tar.gz.

File metadata

  • Download URL: sovos_router-0.1.0.tar.gz
  • Upload date:
  • Size: 40.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for sovos_router-0.1.0.tar.gz
Algorithm Hash digest
SHA256 9e47b30852cd6324745b45147f1a6a0e991b884875cc60ff51eb2a2c01b40ded
MD5 e1a6bc112a419b7ed8ad482b0043f67b
BLAKE2b-256 d10101e4e1c815ed4a4f41c4ea6f7e4e9dfc1a292f503128296590fa03679ada

See more details on using hashes here.

File details

Details for the file sovos_router-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: sovos_router-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 43.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for sovos_router-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ea0b831efa0def80b146416924d3bf0aba94d1467a8f87be12fb71f9fc77338e
MD5 e2d5386ca3002d14657ca4273bb742e5
BLAKE2b-256 90d7d981f0235370070c40b63e1b71a03d087152989d697f022b2fe04b93d1c8

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page