j3ssie/osmedeusUm Motor de Orquestração Moderno para Segurança
# 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 - Um Motor de Orquestração Moderno para Segurança</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>
## O que é o Osmedeus?
[Osmedeus](https://www.osmedeus.org) é um motor de orquestração declarativo focado em segurança que simplifica a automação de fluxos de trabalho complexos em definições YAML auditáveis, completas com tratamento de dados criptografados, gestão segura de credenciais e execução em sandbox.
Criado tanto para iniciantes quanto para especialistas, ele oferece automação poderosa e composável sem sacrificar a integridade e a segurança da sua infraestrutura.
## Principais Recursos
- **Fluxos de Trabalho YAML Declarativos** - Defina pipelines com hooks, roteamento de decisões, exclusão de módulos e ramificação condicional em múltiplos runners (host, Docker, SSH)
- **Execução Distribuída** - Padrão master-worker baseado em Redis com sistema de filas, gatilhos de webhook e sincronização de arquivos entre workers
- **Biblioteca Rica de Funções** - Mais de 80 funções utilitárias, incluindo integração com nmap, sessões tmux, execução SSH, scripting em TypeScript/Python, parsing de SARIF e classificação de CDN/WAF
- **Agendamento Orientado a Eventos** - Gatilhos de cron, file-watch e eventos com filtragem, deduplicação e filas de tarefas atrasadas
- **Etapas de LLM Agênticas** - Loops de agentes com chamada de ferramentas, orquestração de subagentes, gestão de memória e saída estruturada; além de agentes de subprocesso ACP (Claude Code, Codex, OpenCode, Gemini)
- **Infraestrutura em Nuvem** - Provisione e execute varreduras em DigitalOcean, AWS, GCP, Linode e Azure com controles de custo e limpeza automática
- **Interface CLI Rica** - Consultas interativas ao banco de dados, avaliação em massa de funções, linting de fluxos de trabalho, barras de progresso e exemplos de uso abrangentes
- **API REST e Interface Web** - Servidor de API completo com gatilhos de webhook, consultas ao banco de dados e painel incorporado para visualização
Consulte a [Página de Documentação](https://docs.osmedeus.org/) para mais detalhes.
## Instalação
```bash
curl -sSL http://www.osmedeus.org/install.sh | bash
```
### [npm](https://www.npmjs.com/package/@j3ssie/osmedeus)
```bash
npm install -g @j3ssie/osmedeus
```
Fornece binários pré-compilados para linux e macOS em x64/arm64.
Consulte o [Quickstart](https://docs.osmedeus.org/quickstart/) para uma configuração rápida e a [Installation](https://docs.osmedeus.org/installation/) para configurações avançadas.
| Uso da CLI | Recursos da Web UI |
|-----------|---------------|
|  |  |
| **Visualização de Workflow** | **Vulnerabilidades** |
|  |  |
## ☁️ Patrocinador — Bloome
[](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607)
Automatizando recon com o Osmedeus? O [Bloome](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607) traz essa mesma mentalidade de time-de-agentes para o restante do seu fluxo de trabalho: múltiplos agentes de IA (Claude, ChatGPT, DeepSeek e mais) em um único chat compartilhado que divide o trabalho, repassa tarefas, faz verificação cruzada entre si e refina a saída até ficar correta — triagem de achados, redação de relatórios e execução de verificações agendadas em conjunto. Zero configuração, na nuvem, na web e no celular, e compartilhável com seu time. 👉 [Experimente o Bloome](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607)
## Início Rápido
```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
```
Para mais informações sobre o uso da CLI e comandos de exemplo, consulte a [Referência da CLI](https://docs.osmedeus.org/getting-started/cli).
## Arquitetura de Alto Nível
```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 │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└───────────────────────────────────────────────────────────────────────────┘
```
Para mais informações sobre a arquitetura, consulte a [Documentação de Arquitetura](https://docs.osmedeus.org/architecture).
## Roadmap e Status
O plano ambicioso de alto nível para o projeto, em ordem:
| # | Etapa | Status |
| :-: | --------------------------------------------------------------------------- | :----: |
| 1 | Osmedeus Engine reformulado com uma arquitetura de próxima geração | ✅ |
| 2 | Workflows e tipos de etapas flexíveis | ✅ |
| 3 | Modelo arquitetural orientado a eventos e as diferentes categorias de eventos de gatilho | ✅ |
| 4 | Interface bonita para visualizar resultados e diagrama de workflow | ✅ |
| 5 | Reescrever o workflow para se adaptar à nova arquitetura e sintaxe | ✅ |
| 6 | Testar mais funções utilitárias, como notificações | ✅ |
| 7 | Integração SAST com análise SARIF (Semgrep, Trivy, etc.) | ✅ |
| 8 | Integração com a nuvem, que permite executar a varredura no provedor de nuvem. | ✅ |
| 9 | Gerar relatórios de diferenças mostrando ativos novos/removidos/inalterados entre execuções. | ❌ |
| 10 | Adicionar tipo de etapa do provedor de nuvem que pode ser executado via serverless | ❌ |
| N | Recursos sofisticados (a serem discutidos posteriormente) | ❌ |
## Documentação
| Tópico | Link |
|----------------------|----------------------------------------------------------------------------------------------------------|
| Primeiros Passos | [docs.osmedeus.org/getting-started](https://docs.osmedeus.org/getting-started) |
| Uso da CLI e Exemplos | [docs.osmedeus.org/getting-started/cli](https://docs.osmedeus.org/getting-started/cli) |
| Escrevendo Workflows | [docs.osmedeus.org/workflows/overview](https://docs.osmedeus.org/workflows/overview) |
| Gatilhos Orientados a Eventos| [docs.osmedeus.org/advanced/event-driven](https://docs.osmedeus.org/advanced/event-driven) |
| Implantação | [docs.osmedeus.org/deployment](https://docs.osmedeus.org/deployment) |
| Arquitetura | [docs.osmedeus.org/concepts/architecture](https://docs.osmedeus.org/concepts/architecture) |
| Desenvolvimento | [docs.osmedeus.org/development](https://docs.osmedeus.org/development) e [HACKING.md](https://github.com/j3ssie/osmedeus/blob/main/HACKING.md) |
| Estendendo o Osmedeus | [docs.osmedeus.org/development/extending-osmedeus](https://docs.osmedeus.org/development/extending-osmedeus) |
| Modelo de Segurança | [SECURITY.md](https://github.com/j3ssie/osmedeus/blob/main/SECURITY.md) e [docs.osmedeus.org/others/security-warning](https://docs.osmedeus.org/others/security-warning) |
| Documentação Completa | [docs.osmedeus.org](https://docs.osmedeus.org) |
## Aviso Legal
**Osmedeus** foi projetado para executar código e comandos arbitrários a partir de entrada fornecida pelo usuário via CLI, API e definições de workflow. Essa flexibilidade é intencional e central para o funcionamento do motor.
Consulte a página [⚠️ Aviso de Segurança](https://docs.osmedeus.org/others/security-warning) para mais informações sobre como se manter seguro. O [SECURITY.md](https://github.com/j3ssie/osmedeus/blob/main/SECURITY.md) traça a linha entre a execução de código que é intencional e o que conta como vulnerabilidade, e é o ponto de partida caso queira relatar uma.
**Pense duas vezes antes de:**
- Executar workflows baixados de fontes não confiáveis
- Executar comandos ou varreduras contra alvos que você não possui ou não tem permissão para testar
- Usar workflows sem revisar seu conteúdo primeiro
Você é responsável pelo que executa. Sempre revise os arquivos YAML de workflow antes da execução, especialmente aqueles obtidos de terceiros.
## Licença
Osmedeus é feito com ♥ por [@j3ssie](https://twitter.com/j3ssie) e é lançado sob a licença MIT.