Inspect shard capacity
Expand shards, spillover policies and nodes. Earth, Luna and Mars are scenario labels; latency budgets and capacities are model inputs.
demo/Planetary-Orchestrator-Fabric-v0/config/fabric.example.json ↗Scale & orchestration
Planetary Orchestrator Fabric
Explore large-scale orchestration through its documented model and scenarios.
A CLOSER LOOK
Can work recover when an orchestrator restarts?
For distributed-system builders: inspect shard routing, queue pressure, reassignment and checkpoint recovery in a seeded local workload.
Follow routing and recovery
Trace generated jobs through the high-load simulation and kill/resume path. Completion and reassignment are evidence about this local workload.
demo/Planetary-Orchestrator-Fabric-v0/planetary_fabric/simulation.py ↗Choose a bounded run
The CLI supports jobs, seed, base-dir and no-restart. A small job count is suitable for learning the mechanics before a larger stress run.
demo/Planetary-Orchestrator-Fabric-v0/run_demo.py ↗REAL REPOSITORY MATERIAL
Inspect. Understand. Reproduce.
Reading the exact source at revision 5b4cebb3.
This browser inspection does not execute the demo.
demo/Planetary-Orchestrator-Fabric-v0/config/fabric.example.json
Select a walkthrough step to explore its source.
Full source text
{
"owner": {
"name": "Planetary Fabric Owner",
"address": "0xF4BR1C0000000000000000000000000000000WN",
"multisig": "0xFABR1C00000000000000000000000000000000MS",
"pauseRole": "SystemPause",
"commandDeck": [
"owner:pause-all",
"owner:update-thermostat",
"owner:reroute-shard",
"owner:set-latency-budget",
"owner:register-shard",
"owner:deregister-shard"
]
},
"shards": [
{
"id": "earth",
"displayName": "Earth Hypergrid",
"latencyBudgetMs": 120,
"spilloverTargets": ["luna", "mars"],
"maxQueue": 6000,
"router": {
"queueAlertThreshold": 4200,
"spilloverPolicies": [
{ "target": "luna", "threshold": 4500, "maxDrainPerTick": 50 },
{ "target": "mars", "threshold": 5000, "maxDrainPerTick": 75 }
]
}
},
{
"id": "luna",
"displayName": "Luna Relay",
"latencyBudgetMs": 180,
"spilloverTargets": ["earth"],
"maxQueue": 2400,
"router": {
"queueAlertThreshold": 1600,
"spilloverPolicies": [
{ "target": "earth", "threshold": 1800, "maxDrainPerTick": 40 }
]
}
},
{
"id": "mars",
"displayName": "Mars Foundry",
"latencyBudgetMs": 420,
"spilloverTargets": ["earth", "helios"],
"maxQueue": 4000,
"router": {
"queueAlertThreshold": 3000,
"spilloverPolicies": [
{ "target": "earth", "threshold": 3200, "maxDrainPerTick": 30, "requiredSkills": ["manufacturing"] },
{ "target": "helios", "threshold": 3600, "maxDrainPerTick": 30, "requiredSkills": ["gpu", "vision"] }
]
}
},
{
"id": "helios",
"displayName": "Helios GPU Helion",
"latencyBudgetMs": 850,
"spilloverTargets": ["mars"],
"maxQueue": 2200,
"router": {
"queueAlertThreshold": 1600,
"spilloverPolicies": [
{ "target": "mars", "threshold": 1800, "maxDrainPerTick": 20 }
]
}
}
],
"nodes": [
{
"id": "earth.core-alpha",
"region": "earth",
"capacity": 24,
"specialties": ["general", "finance", "compliance"],
"heartbeatIntervalSec": 12,
"maxConcurrency": 24,
"endpoint": "https://earth-core-alpha.fabric.ops/api",
"deployment": {
"orchestration": "kubernetes",
"runtime": "node-lts",
"image": "registry.agi/earth-core-alpha:2.1.0",
"version": "2.1.0",
"entrypoint": "/opt/agi/start-core-alpha.sh",
"resources": { "cpuCores": 32, "memoryGb": 128, "gpuClass": "A10", "storageGb": 512 }
},
"availabilityZones": ["earth-central-1a", "earth-central-1b"],
"pricing": { "amount": 0.00072, "currency": "USDC", "unit": "job", "notes": "Includes compliance attestation" },
"tags": ["finance-hub", "tier-zero"],
"compliance": ["SOC2-Type-II", "GDPR"]
},
{
"id": "earth.edge-europa",
"region": "earth",
"capacity": 16,
"specialties": ["logistics", "iot", "edge"],
"heartbeatIntervalSec": 18,
"maxConcurrency": 12,
"endpoint": "https://edge-europa.fabric.ops/api",
"deployment": {
"orchestration": "nomad",
"runtime": "wasm",
"image": "registry.agi/edge-europa:3.5.2",
"version": "3.5.2",
"entrypoint": "/srv/bin/bootstrap",
"resources": { "cpuCores": 12, "memoryGb": 48, "storageGb": 256 }
},
"availabilityZones": ["earth-edge-1"],
"pricing": { "amount": 0.00038, "currency": "USDC", "unit": "job" },
"tags": ["edge", "iot"],
"compliance": ["ISO-27001"]
},
{
"id": "luna.nav-station",
"region": "luna",
"capacity": 12,
"specialties": ["navigation", "observation"],
"heartbeatIntervalSec": 18,
"maxConcurrency": 10,
"endpoint": "https://luna-nav.fabric.ops/api",
"deployment": {
"orchestration": "kubernetes",
"runtime": "python-3.11",
"image": "registry.agi/luna-nav-station:1.2.8",
"version": "1.2.8",
"entrypoint": "/opt/agi/luna-nav.sh",
"resources": { "cpuCores": 10, "memoryGb": 32, "storageGb": 128 }
},
"availabilityZones": ["luna-orbit-a"],
"pricing": { "amount": 0.00028, "currency": "USDC", "unit": "job" },
"tags": ["luna", "relay"],
"compliance": ["Lunar-Safety-Standard"]
},
{
"id": "mars.regolith-cradle",
"region": "mars",
"capacity": 18,
"specialties": ["manufacturing", "terraforming"],
"heartbeatIntervalSec": 20,
"maxConcurrency": 14,
"endpoint": "https://mars-regolith.fabric.ops/api",
"deployment": {
"orchestration": "nomad",
"runtime": "rust-optimized",
"image": "registry.agi/mars-regolith:4.0.0",
"version": "4.0.0",
"entrypoint": "/opt/agi/regolith.sh",
"resources": { "cpuCores": 20, "memoryGb": 72, "storageGb": 384 }
},
"availabilityZones": ["mars-foundry-a", "mars-foundry-b"],
"pricing": { "amount": 0.00055, "currency": "USDC", "unit": "job" },
"tags": ["manufacturing", "mars"],
"compliance": ["Mars-Colony-Safety"]
},
{
"id": "mars.gpu-helion",
"region": "mars",
"capacity": 32,
"specialties": ["gpu", "vision", "simulation"],
"heartbeatIntervalSec": 10,
"maxConcurrency": 20,
"endpoint": "https://mars-gpu-helion.fabric.ops/api",
"deployment": {
"orchestration": "kubernetes",
"runtime": "cuda",
"image": "registry.agi/mars-gpu-helion:5.3.1",
"version": "5.3.1",
"entrypoint": "/opt/agi/run-gpu.sh",
"resources": { "cpuCores": 40, "memoryGb": 160, "gpuClass": "A100", "storageGb": 512 }
},
"availabilityZones": ["mars-gpu-east"],
"pricing": { "amount": 0.00088, "currency": "USDC", "unit": "job", "notes": "High-priority GPU lane" },
"tags": ["gpu", "critical"],
"compliance": ["Mars-Colony-Safety", "SOC2-Type-II"]
},
{
"id": "helios.solaris-array",
"region": "helios",
"capacity": 28,
"specialties": ["gpu", "astronomy"],
"heartbeatIntervalSec": 9,
"maxConcurrency": 18,
"endpoint": "https://helios-solaris.fabric.ops/api",
"deployment": {
"orchestration": "kubernetes",
"runtime": "cuda",
"image": "registry.agi/helios-solaris:6.2.0",
"version": "6.2.0",
"entrypoint": "/opt/agi/launch-helion.sh",
"resources": { "cpuCores": 36, "memoryGb": 144, "gpuClass": "H100", "storageGb": 512 }
},
"availabilityZones": ["helios-array-a", "helios-array-b"],
"pricing": { "amount": 0.0012, "currency": "USDC", "unit": "job", "notes": "Premium solar analytics lane" },
"tags": ["helios", "premium"],
"compliance": ["SOC2-Type-II", "Solaris-Safety"]
}
],
"checkpoint": {
"path": "demo/Planetary-Orchestrator-Fabric-v0/storage/checkpoint.json",
"intervalTicks": 20
},
"reporting": {
"directory": "demo/Planetary-Orchestrator-Fabric-v0/reports",
"defaultLabel": "latest"
}
}
SHA-256 83ad3f03cad71b2f0efcd951d43f474b95aa5e308147210ee248ee8d988655e1
FROM READING TO A REPRODUCIBLE RUN
Try the selected path.
Python, no demo package installRun from the repository root with Python 3.12. This selected entry point uses the Python standard library. Keep output in a separate directory so that you can compare runs.
Complete environment setup ↗python demo/Planetary-Orchestrator-Fabric-v0/run_demo.py --jobs 100 --seed 1337 --base-dir /tmp/planetary-demoWhat you should observe
The terminal prints completion_rate, max_depth_delta, reassigned_jobs and total_runtime; the base directory holds checkpoints and telemetry.
The source inspector above reads bundled repository material. Local commands run separately on your computer. Recorded examples may contain historical timestamps, placeholders and simulated metrics.
MAKE IT YOUR OWN
One useful experiment.
Compare the same workload with and without --no-restart. Explain changes in reassignment and runtime while checking that all intended jobs are accounted for.
THE SYSTEM, MADE VISIBLE
Architecture & relationships
View original Mermaid source
flowchart LR
Operators((Mission Owners)) --> demo_Planetary_Orchestrator_Fabric_v0[[Demo → Planetary Orchestrator Fabric v0]]
demo_Planetary_Orchestrator_Fabric_v0 --> Core[[AGI Jobs v0 (v2) Core Intelligence]]
Core --> Observability[[Unified CI / CD & Observability]]
Core --> Governance[[Owner Control Plane]]WHEN SOMETHING DOESN’T MATCH
Troubleshooting
Import or dependency error
Confirm the active virtual environment and the selected demo’s requirements. Run python -m pip check; do not install unrelated demo requirements over a working environment.
Unexpected result or missing file
Check the selected entry point, configuration and output argument. Keep the seed and implementation fixed before comparing outcomes.
TRACE THE CHECKS
Verification & next steps
5 tracked test source files are available in this directory. Inspect the tests and their environment before choosing a suite; file counts do not establish test results.
Browse the test sources
For live commissioning, consult the production readiness record.
EVERY VARIANT, PRESERVED
Complete document library
REPRODUCE & INSPECT
Registered commands
Run commands from the repository root after following this demo's guide. Network and owner actions require their documented setup.
npm run demo:planetary-orchestrator-fabricnpm run demo:planetary-orchestrator-fabric:cinpm run demo:planetary-orchestrator-fabric:restartnpm run demo:planetary-orchestrator-fabric:acceptancenpm run demo:planetary-orchestrator-fabric:workbenchnpm run demo:planetary-orchestrator-fabric:worker