Skip to main content
Introduction Banner
Osmedeus is a security focused declarative orchestration engine that simplifies complex workflow automation into auditable YAML definitions, complete with encrypted data handling, secure credential management, and sandboxed execution. Built for both beginners and experts, it delivers powerful, composable automation without sacrificing the integrity and safety of your infrastructure.

Key Features

  • Declarative YAML Workflows - Define reconnaissance pipelines using simple, readable YAML syntax
  • Two Workflow Types - Modules for single execution units, Flows for multi-module orchestration
  • Multiple Runners - Execute on local host, Docker containers, or remote machines via SSH
  • Distributed Execution - Scale with Redis-based master-worker pattern for parallel scanning
  • Template Engine - Powerful variable interpolation with {{Variable}} syntax
  • Utility Functions - Rich function library for file operations, string manipulation, and JSON processing
  • REST API Server - Manage and trigger workflows programmatically
  • LLM Integration - AI-powered workflow steps with chat completions and embeddings

Hall of fame in light mode

Getting Started

Quickstart

Jump right in and run your first Osmedeus workflow in minutes.

Advanced Installation and Configuration

Understanding Osmedeus

Core Concepts

PageDescription
ArchitectureLayered architecture and data flow
WorkflowsModule vs Flow, execution lifecycle
TemplatesVariable interpolation and built-in variables
RunnersHost, Docker, SSH execution environments
FunctionsJavaScript utility functions that bind to the core engine for use in workflow steps

Advanced Topics

PageDescription
Distributed ExecutionMaster-worker architecture
SchedulingCron, event, and file-watch triggers
LLM IntegrationAI-powered workflow steps
SnapshotsWorkspace export and import

Workflows

PageDescription
OverviewYAML structure and workflow kinds
Step TypesAll 7 step types with examples
FlowsModule orchestration and dependencies
VariablesParameters, exports, variable propagation
Control FlowConditions, handlers, and decision routing

Extending Osmedeus

PageDescription
Step TypesAdd custom step executors
RunnersImplement new runner types
FunctionsRegister utility functions
CLI CommandsAdd new CLI commands
API EndpointsAdd new REST endpoints

Reference

PageDescription
Workflow SchemaComplete YAML schema
VariablesBuilt-in variables
TypesGo type definitions