osmedeus

A Modern Orchestration Engine for Security

What is osmedeus?

A Modern Orchestration Engine for Security

Overview of osmedeus

What it is

Osmedeus is a security-focused declarative orchestration engine that simplifies complex workflow automation into auditable YAML definitions. It includes encrypted data handling, secure credential management, and sandboxed execution. It is designed for both beginners and experts, providing composable automation without compromising infrastructure integrity and safety.

Key features

  • Declarative YAML workflows with hooks, decision routing, module exclusion, and conditional branching across host, Docker, and SSH runners
  • Distributed execution using a Redis-based master-worker pattern with queue system, webhook triggers, and file sync across workers
  • Rich function library with over 80 utility functions including nmap integration, tmux sessions, SSH execution, TypeScript/Python scripting, SARIF parsing, and CDN/WAF classification
  • Event-driven scheduling with cron, file-watch, and event triggers, plus filtering, deduplication, and delayed task queues
  • Agentic LLM steps with tool-calling agent loops, sub-agent orchestration, memory management, structured output, and ACP subprocess agents (Claude Code, Codex, OpenCode, Gemini)
  • Cloud infrastructure provisioning and scanning across DigitalOcean, AWS, GCP, Linode, and Azure with cost controls and automatic cleanup
  • Rich CLI interface with interactive database queries, bulk function evaluation, workflow linting, progress bars, and comprehensive usage examples
  • REST API and Web UI with full API server, webhook triggers, database queries, and embedded dashboard for visualization

Use cases

Osmedeus is used for security scanning and reconnaissance automation. It can run module workflows (e.g., osmedeus run -m recon -t example.com) and flow workflows (e.g., osmedeus run -f general -t example.com). It supports multiple targets with concurrency, dry-run mode, API server startup, workflow listing, asset querying, vulnerability querying, and database table queries. It also supports worker queue systems, cloud infrastructure management, and agent-based analysis.

Getting started

bashcurl -sSL http://www.osmedeus.org/install.sh | bashOr via npm:bashnpm install -g @j3ssie/osmedeusPrebuilt binaries for Linux and macOS on x64/arm64 are available. See the repository README for Quickstart and advanced installation.

License and pricing

The license is MIT. The project is open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/j3ssieosmedeus.svg)](https://yunodb.com/tools/j3ssieosmedeus?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/j3ssieosmedeus?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/j3ssieosmedeus.svg" alt="Featured on YunoDB" height="20"></a>