Osmedeus

Osmedeus - Eine moderne Orchestrierungs-Engine für Sicherheit

Was ist Osmedeus?

Osmedeus ist eine sicherheitsorientierte deklarative Orchestrierungs-Engine, die komplexe Workflow-Automatisierung in prüfbare YAML-Definitionen vereinfacht – inklusive verschlüsselter Datenverarbeitung, sicherer Verwaltung von Zugangsdaten und sandboxed Ausführung.

Entwickelt sowohl für Einsteiger als auch für Experten, bietet es leistungsstarke, komponierbare Automatisierung, ohne die Integrität und Sicherheit Ihrer Infrastruktur zu beeinträchtigen.

Hauptfunktionen

• Deklarative YAML-Workflows – Definieren Sie Pipelines mit Hooks, Entscheidungsrouting, Modulausschluss und bedingter Verzweigung über mehrere Runner (Host, Docker, SSH)
• Verteilte Ausführung – Redis-basiertes Master-Worker-Muster mit Queue-System, Webhook-Triggern und Dateisynchronisierung zwischen Workern
• Umfangreiche Funktionsbibliothek – Über 80 Hilfsfunktionen, darunter nmap-Integration, tmux-Sitzungen, SSH-Ausführung, TypeScript/Python-Skripting, SARIF-Parsing und CDN/WAF-Klassifizierung
• Ereignisgesteuerte Planung – Cron-, File-Watch- und Ereignis-Trigger mit Filterung, Deduplizierung und verzögerten Aufgabenwarteschlangen
• Agentische LLM-Schritte – Tool-Calling-Agent-Schleifen mit Sub-Agent-Orchestrierung, Speicherverwaltung und strukturierter Ausgabe; plus ACP-Subprozess-Agenten (Claude Code, Codex, OpenCode, Gemini)
• Cloud-Infrastruktur – Bereitstellung und Ausführung von Scans über DigitalOcean, AWS, GCP, Linode und Azure mit Kostenkontrolle und automatischer Bereinigung
• Umfangreiche CLI-Oberfläche – Interaktive Datenbankabfragen, Massenauswertung von Funktionen, Workflow-Linting, Fortschrittsbalken und umfassende Anwendungsbeispiele
• REST-API & Web-UI – Vollständiger API-Server mit Webhook-Triggern, Datenbankabfragen und eingebettetem Dashboard zur Visualisierung

Weitere Details finden Sie auf der Dokumentationsseite.

Installation

curl -sSL http://www.osmedeus.org/install.sh | bash

npm

npm install -g @j3ssie/osmedeus

Enthält vorgefertigte Binärdateien für Linux und macOS auf x64/arm64.

Siehe Quickstart für eine schnelle Einrichtung und Installation für erweiterte Konfigurationen.

CLI-Nutzung	Web-UI-Assets
Workflow-Visualisierung	Schwachstellen

☁️ Sponsor — Bloome

Automatisierst du Recon mit Osmedeus? Bloome bringt dieselbe Denkweise eines Agenten-Teams in den Rest deines Workflows: mehrere KI-Agenten (Claude, ChatGPT, DeepSeek und mehr) in einem gemeinsamen Chat, die die Arbeit aufteilen, Aufgaben übergeben, sich gegenseitig überprüfen und die Ausgabe verfeinern, bis sie stimmt — Befunde triagieren, Berichte entwerfen und geplante Prüfungen gemeinsam ausführen. Keine Einrichtung, in der Cloud, auf Web und Mobil und mit deinem Team teilbar. 👉 Bloome ausprobieren

Schnellstart

# Run a module workflow
osmedeus run -m recon -t example.com

# Run a flow workflow
osmedeus run -f general -t example.com

# Multiple targets with concurrency
osmedeus run -m recon -T targets.txt -c 5

# Dry-run mode (preview)
osmedeus run -f general -t example.com --dry-run

# Start API server
osmedeus serve

# List available workflows
osmedeus workflow list

# Query discovered assets
osmedeus assets -w example.com                          # List assets for workspace
osmedeus assets --stats                                 # Show unique technologies, sources, types
osmedeus assets --source httpx --type web --json        # Filter and output as JSON

# Query vulnerabilities, runs, and steps
osmedeus query vulns --severity high --workspace example.com
osmedeus query runs --status running
osmedeus query steps --run <run-uuid>

# Query database tables
osmedeus db list --table runs
osmedeus db list --table event_logs --search "nuclei"

# Evaluate utility functions
osmedeus func eval 'log_info("hello")'
osmedeus func eval -e 'http_get("https://example.com")' -T targets.txt -c 10

# Platform variables available in eval
osmedeus func eval 'log_info("OS: " + PlatformOS + ", Arch: " + PlatformArch)'

# Install from preset repositories
osmedeus install base --preset
osmedeus install base --preset --keep-setting   # preserve existing osm-settings.yaml
osmedeus install workflow --preset

# Exclude modules from flow execution
osmedeus run -f general -t example.com -x portscan
osmedeus run -f general -t example.com -X vuln    # Fuzzy exclude by substring

# Worker queue system
osmedeus worker queue new -f general -t example.com   # Queue for later
osmedeus worker queue run --concurrency 5              # Process queue

# Worker management
osmedeus worker status                          # Show workers
osmedeus worker eval -e 'ssh_exec("host", "whoami")'  # Eval with distributed hooks

# Run an ACP agent interactively
osmedeus agent "analyze this codebase"
osmedeus agent --agent codex "explain main.go"
osmedeus agent --list

# Cloud infrastructure management
osmedeus cloud create --instances 3                    # Provision cloud machines
osmedeus cloud setup 1.2.3.4 5.6.7.8                  # Setup existing machines
osmedeus cloud list                                    # List active infrastructure
osmedeus cloud run -f general -t example.com --instances 3

# Show all usage examples
osmedeus --usage-example

Docker

# Show help
docker run --rm j3ssie/osmedeus:latest --help