sim-orchestrator

Coordinate Neo4j, Kafka, and domain services to boot, seed, and drive the virtual clock.

11|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Jupiter41/arthur-airport --skill sim-orchestrator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sim-orchestrator
Source: https://github.com/Jupiter41/arthur-airport/tree/main/services/sim-orchestrator
Command: npx skills add https://github.com/Jupiter41/arthur-airport --skill sim-orchestrator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill coordinates the startup, health checks, and clock-driven simulation orchestration across Neo4j, Kafka, and domain services to bootstrap and run the Arthur International Airport twin.

Core Features & Use Cases

  • Orchestrates the initialization sequence: wait for services, seed airport structure and day 1 data, and start the virtual clock.
  • Provides resilience: restart convergence, snapshot support, and readiness checks to ensure safe restarts.
  • Enables observability: metrics endpoints and structured logs to monitor tick processing, speed, and events.

Quick Start

Start the sim-orchestrator by running the FastAPI app with uvicorn (or using the repository's Docker Compose setup) to boot the clock and services.

Frequently Asked Questions about sim-orchestrator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I orchestrate Neo4j, Kafka, and FastAPI services for a digital twin simulation?

You can orchestrate Neo4j, Kafka, and FastAPI services for a digital twin simulation by running a centralized app that applies deterministic startup sequencing and readiness probes to coordinate booting and data seeding. This ensures predictable convergence across all services.

What is the best way to seed day-one data and start a virtual clock for an airport twin?

Seeding day-one data and starting a virtual clock for an airport twin is handled through scenario-driven injections during the initialization sequence. The orchestrator waits for service readiness, seeds the airport structure, and then drives the virtual clock.

Can I use Docker Compose to boot the simulation clock and domain services?

Yes, you can use Docker Compose to boot the simulation clock and domain services. Running the FastAPI app with uvicorn or using the repository's Docker Compose setup initializes the ecosystem and starts the virtual clock.

How does restart convergence and snapshot restore work for simulation orchestration?

Restart convergence and snapshot restore work by applying resilience checks and readiness probes before safe restarts. The orchestrator ensures predictable convergence by monitoring service health and restoring snapshots to maintain simulation state.

How do I monitor tick processing and simulation events for observability?

You monitor tick processing and simulation events for observability through exposed metrics endpoints and structured logs. These features track tick processing speed and simulation events to ensure system health during orchestration.