j3ssie/osmedeusUn moteur d'orchestration moderne pour la sécurité.
# Osmedeus
<p align="center">
<a href="https://www.osmedeus.org"><img alt="Osmedeus" src="https://assets.kitploit.com/production/public/readmes/2279/2023d02ecc03602d346d7a9540570d8144424edcb793863bd708b8af04bcc8e0.png" height="140" /></a>
<br />
<strong>Osmedeus - Un moteur d'orchestration moderne pour la sécurité</strong>
<p align="center">
<a href="https://docs.osmedeus.org/"><img src="https://img.shields.io/badge/Documentation-0078D4?style=for-the-badge&logo=GitBook&logoColor=39ff14&labelColor=black&color=black"></a>
<a href="https://docs.osmedeus.org/donation/"><img src="https://img.shields.io/badge/Sponsors-0078D4?style=for-the-badge&logo=GitHub-Sponsors&logoColor=39ff14&labelColor=black&color=black"></a>
<a href="https://twitter.com/OsmedeusEngine"><img src="https://img.shields.io/badge/@OsmedeusEngine-0078D4?style=for-the-badge&logo=Twitter&logoColor=39ff14&labelColor=black&color=black"></a>
<a href="https://discord.gg/mtQG2FQsYA"><img src="https://img.shields.io/badge/Discord%20Server-0078D4?style=for-the-badge&logo=Discord&logoColor=39ff14&labelColor=black&color=black"></a>
<a href="https://github.com/j3ssie/osmedeus/releases"><img src="https://img.shields.io/github/release/j3ssie/osmedeus?style=for-the-badge&labelColor=black&color=2fc414&logo=Github"></a>
</p>
</p>
## Qu'est-ce qu'Osmedeus ?
[Osmedeus](https://www.osmedeus.org) est un moteur d'orchestration déclaratif axé sur la sécurité qui simplifie l'automatisation de workflows complexes en définitions YAML auditables, avec gestion des données chiffrées, gestion sécurisée des identifiants et exécution en bac à sable.
Conçu aussi bien pour les débutants que pour les experts, il offre une automatisation puissante et composable sans compromettre l'intégrité et la sécurité de votre infrastructure.
## Fonctionnalités clés
- **Workflows YAML déclaratifs** - Définissez des pipelines avec des hooks, un routage décisionnel, l'exclusion de modules et des branchements conditionnels sur plusieurs exécuteurs (hôte, Docker, SSH)
- **Exécution distribuée** - Modèle maître-travailleur basé sur Redis avec système de files d'attente, déclencheurs webhook et synchronisation de fichiers entre les travailleurs
- **Bibliothèque de fonctions riche** - Plus de 80 fonctions utilitaires incluant l'intégration de nmap, les sessions tmux, l'exécution SSH, les scripts TypeScript/Python, l'analyse SARIF et la classification CDN/WAF
- **Planification pilotée par les événements** - Déclencheurs cron, surveillance de fichiers et événements avec filtrage, déduplication et files d'attente de tâches différées
- **Étapes LLM agentiques** - Boucles d'agents avec appel d'outils, orchestration de sous-agents, gestion de la mémoire et sortie structurée ; plus des agents de sous-processus ACP (Claude Code, Codex, OpenCode, Gemini)
- **Infrastructure cloud** - Provisionnez et exécutez des scans sur DigitalOcean, AWS, GCP, Linode et Azure avec contrôle des coûts et nettoyage automatique
- **Interface CLI riche** - Requêtes interactives sur la base de données, évaluation de fonctions en masse, linting de workflows, barres de progression et exemples d'utilisation complets
- **API REST et interface web** - Serveur API complet avec déclencheurs webhook, requêtes sur la base de données et tableau de bord intégré pour la visualisation
Consultez la [page de documentation](https://docs.osmedeus.org/) pour plus de détails.
## Installation
```bash
curl -sSL http://www.osmedeus.org/install.sh | bash
```
### [npm](https://www.npmjs.com/package/@j3ssie/osmedeus)
```bash
npm install -g @j3ssie/osmedeus
```
Fournit des binaires précompilés pour linux et macOS sur x64/arm64.
Consultez [Quickstart](https://docs.osmedeus.org/quickstart/) pour une configuration rapide et [Installation](https://docs.osmedeus.org/installation/) pour les configurations avancées.
| Utilisation du CLI | Ressources de l'interface web |
|-----------|---------------|
|  |  |
| **Visualisation des workflows** | **Vulnérabilités** |
|  |  |
## ☁️ Sponsor — Bloome
[](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607)
Vous automatisez la reconnaissance avec Osmedeus ? [Bloome](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607) apporte ce même état d'esprit d'équipe d'agents au reste de votre flux de travail : plusieurs agents IA (Claude, ChatGPT, DeepSeek et plus encore) dans un chat partagé qui se répartissent le travail, se transmettent les tâches, se vérifient mutuellement et affinent le résultat jusqu'à ce qu'il soit correct — tri des constats, rédaction de rapports et exécution de contrôles planifiés ensemble. Aucune configuration, dans le cloud, sur le web et le mobile, et partageable avec votre équipe. 👉 [Essayez Bloome](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607)
## Démarrage rapide
```bash
# 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
```bash
# Show help
docker run --rm j3ssie/osmedeus:latest --help
# Run a scan
docker run --rm -v $(pwd)/output:/root/workspaces-osmedeus \
j3ssie/osmedeus:latest run -f general -t example.com
```
Pour plus d'informations sur l'utilisation de la CLI et des exemples de commandes, consultez la [référence CLI](https://docs.osmedeus.org/getting-started/cli).
## Architecture de haut niveau
```plaintext
┌───────────────────────────────────────────────────────────────────────────┐
│ Osmedeus Orchestration Engine │
├───────────────────────────────────────────────────────────────────────────┤
│ ENTRY POINTS │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
│ │ CLI │ │ REST API │ │Scheduler │ │ Distributed │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └─────┬───────┘ │
│ └─────────────┴─────────────┴──────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ CONFIG ──▶ PARSER ──▶ EXECUTOR ──▶ STEP DISPATCHER ──▶ RUNNER │ │
│ │ │ │ │
│ │ Step Executors: bash | function | parallel | foreach | remote-bash │ │
│ │ http | llm | agent | agent-acp | SARIF/SAST │ │
│ │ Hooks: pre_scan_steps → [main steps] → post_scan_steps │ │
│ │ │ │ │
│ │ Runners: HostRunner | DockerRunner | SSHRunner │ │
│ │ Queue: DB + Redis polling → dedup → concurrent execution │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└───────────────────────────────────────────────────────────────────────────┘
```
Pour plus d'informations sur l'architecture, consultez la [Documentation de l'architecture](https://docs.osmedeus.org/architecture).
## Feuille de route et état d'avancement
Le plan ambitieux à haut niveau pour le projet, dans l'ordre :
| # | Étape | Statut |
| :-: | --------------------------------------------------------------------------- | :----: |
| 1 | Moteur Osmedeus refondu avec une architecture de nouvelle génération | ✅ |
| 2 | Workflows et types d'étapes flexibles | ✅ |
| 3 | Modèle architectural événementiel et les différentes catégories d'événements déclencheurs | ✅ |
| 4 | Interface utilisateur élégante pour visualiser les résultats et le diagramme de workflow | ✅ |
| 5 | Réécriture du workflow pour s'adapter à la nouvelle architecture et syntaxe | ✅ |
| 6 | Test de davantage de fonctions utilitaires comme les notifications | ✅ |
| 7 | Intégration SAST avec analyse SARIF (Semgrep, Trivy, etc.) | ✅ |
| 8 | Intégration cloud, qui permet d'exécuter le scan sur le fournisseur cloud. | ✅ |
| 9 | Génération de rapports de différences montrant les actifs nouveaux/supprimés/inchangés entre les exécutions. | ❌ |
| 10 | Ajout d'un type d'étape issu du fournisseur cloud pouvant être exécuté via serverless | ❌ |
| N | Fonctionnalités avancées (à discuter ultérieurement) | ❌ |
## Documentation
| Sujet | Lien |
|----------------------|----------------------------------------------------------------------------------------------------------|
| Premiers pas | [docs.osmedeus.org/getting-started](https://docs.osmedeus.org/getting-started) |
| Utilisation de la CLI et exemples | [docs.osmedeus.org/getting-started/cli](https://docs.osmedeus.org/getting-started/cli) |
| Écriture de workflows | [docs.osmedeus.org/workflows/overview](https://docs.osmedeus.org/workflows/overview) |
| Déclencheurs événementiels| [docs.osmedeus.org/advanced/event-driven](https://docs.osmedeus.org/advanced/event-driven) |
| Déploiement | [docs.osmedeus.org/deployment](https://docs.osmedeus.org/deployment) |
| Architecture | [docs.osmedeus.org/concepts/architecture](https://docs.osmedeus.org/concepts/architecture) |
| Développement | [docs.osmedeus.org/development](https://docs.osmedeus.org/development) et [HACKING.md](https://github.com/j3ssie/osmedeus/blob/main/HACKING.md) |
| Étendre Osmedeus | [docs.osmedeus.org/development/extending-osmedeus](https://docs.osmedeus.org/development/extending-osmedeus) |
| Modèle de sécurité | [SECURITY.md](https://github.com/j3ssie/osmedeus/blob/main/SECURITY.md) et [docs.osmedeus.org/others/security-warning](https://docs.osmedeus.org/others/security-warning) |
| Documentation complète | [docs.osmedeus.org](https://docs.osmedeus.org) |
## Avertissement
**Osmedeus** est conçu pour exécuter du code et des commandes arbitraires à partir d'entrées fournies par l'utilisateur via la CLI, l'API et les définitions de workflows. Cette flexibilité est intentionnelle et essentielle au fonctionnement du moteur.
Veuillez consulter la page [⚠️ Avertissement de sécurité](https://docs.osmedeus.org/others/security-warning) pour plus d'informations sur la manière de rester en sécurité. [SECURITY.md](https://github.com/j3ssie/osmedeus/blob/main/SECURITY.md) établit la frontière entre l'exécution de code qui est intentionnelle et ce qui compte comme une vulnérabilité, et constitue le point de départ si vous souhaitez en signaler une.
**Réfléchissez à deux fois avant de :**
- Exécuter des workflows téléchargés depuis des sources non fiables
- Exécuter des commandes ou des scans contre des cibles que vous ne possédez pas ou pour lesquelles vous n'avez pas l'autorisation de tester
- Utiliser des workflows sans en avoir d'abord examiné le contenu
Vous êtes responsable de ce que vous exécutez. Examinez toujours les fichiers YAML de workflow avant leur exécution, en particulier ceux obtenus auprès de tiers.
## Licence
Osmedeus est fait avec ♥ par [@j3ssie](https://twitter.com/j3ssie) et est publié sous la licence MIT.