Horus Documentation
Hierarchical Orchestration Runtime for Universal Scripts
Horus is a distributed job execution system with three layers: Coordinator, Supervisor, and Runner.
Quick Links
- Getting Started - Install and run your first job
- Architecture - System design and components
- Etymology - The meaning behind the name
Components
Coordinator
Workflow orchestration engine for DAG-based execution.
Supervisor
Job dispatcher with authentication and routing.
Runners
Job executors for different workload types.
- Runner Overview
- Hero Runner - Heroscript execution
- SAL Runner - System operations
- Osiris Runner - Database operations
Core Concepts
Jobs
Units of work executed by runners. Each job contains:
- Target runner ID
- Payload (script/command)
- Cryptographic signature
- Optional timeout and environment variables
Workflows
Multi-step DAGs executed by the Coordinator. Steps can:
- Run in parallel or sequence
- Pass data between steps
- Target different runners
- Handle errors and retries
Signatures
All jobs must be cryptographically signed:
- Ensures job authenticity
- Prevents tampering
- Enables authorization
Use Cases
- Automation: Execute system tasks and scripts
- Data Pipelines: Multi-step ETL workflows
- CI/CD: Build, test, and deployment pipelines
- Infrastructure: Manage cloud resources and containers
- Integration: Connect systems via scripted workflows