{"id":13509706,"url":"https://github.com/j3ssie/osmedeus","last_synced_at":"2026-01-24T17:16:56.962Z","repository":{"id":37502390,"uuid":"156946744","full_name":"j3ssie/osmedeus","owner":"j3ssie","description":"A Modern Orchestration Engine for Security","archived":false,"fork":false,"pushed_at":"2026-01-18T17:17:10.000Z","size":189395,"stargazers_count":6028,"open_issues_count":20,"forks_count":955,"subscribers_count":135,"default_branch":"main","last_synced_at":"2026-01-18T17:44:00.114Z","etag":null,"topics":["attack-surface-management","bug-bounty","bugbounty","go","hacking","hacking-tool","osint","pentesting","reconnaissance","security","security-tools","workflow-engine","workflows"],"latest_commit_sha":null,"homepage":"https://www.osmedeus.org/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/j3ssie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":null,"patreon":"j3ssie","open_collective":"osmedeus","ko_fi":"j3ssie","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://paypal.me/j3ssiejjj"]}},"created_at":"2018-11-10T04:17:18.000Z","updated_at":"2026-01-18T17:39:43.000Z","dependencies_parsed_at":"2023-12-09T03:14:50.402Z","dependency_job_id":"d443cb31-c73f-43b5-ba56-0157e708c7c0","html_url":"https://github.com/j3ssie/osmedeus","commit_stats":{"total_commits":19,"total_committers":5,"mean_commits":3.8,"dds":0.3157894736842105,"last_synced_commit":"815c261d44f6df1183d77b0b264060eec3168f00"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/j3ssie/osmedeus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j3ssie%2Fosmedeus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j3ssie%2Fosmedeus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j3ssie%2Fosmedeus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j3ssie%2Fosmedeus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j3ssie","download_url":"https://codeload.github.com/j3ssie/osmedeus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j3ssie%2Fosmedeus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28732327,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["attack-surface-management","bug-bounty","bugbounty","go","hacking","hacking-tool","osint","pentesting","reconnaissance","security","security-tools","workflow-engine","workflows"],"created_at":"2024-08-01T02:01:11.805Z","updated_at":"2026-01-24T17:16:56.952Z","avatar_url":"https://github.com/j3ssie.png","language":"Go","funding_links":["https://patreon.com/j3ssie","https://opencollective.com/osmedeus","https://ko-fi.com/j3ssie","https://paypal.me/j3ssiejjj"],"categories":["Go","Recon","bugbounty","🤖 AI \u0026 Machine Learning","其他_安全与渗透","\u003ca id=\"170048b7d8668c50681c0ab1e92c679a\"\u003e\u003c/a\u003e工具","\u003ca id=\"a76463feb91d09b3d024fae798b92be6\"\u003e\u003c/a\u003e侦察\u0026\u0026信息收集\u0026\u0026子域名发现与枚举\u0026\u0026OSINT","security-tools","Repositories","Security \u0026 Privacy Agents"],"sub_categories":["网络服务_其他","\u003ca id=\"375a8baa06f24de1b67398c1ac74ed24\"\u003e\u003c/a\u003e信息收集\u0026\u0026侦查\u0026\u0026Recon\u0026\u0026InfoGather","Red-Teaming Platforms"],"readme":"# Osmedeus\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.osmedeus.org\"\u003e\u003cimg alt=\"Osmedeus\" src=\"https://raw.githubusercontent.com/osmedeus/assets/main/osm-logo-with-white-border.png\" height=\"140\" /\u003e\u003c/a\u003e\n  \u003cbr /\u003e\n  \u003cstrong\u003eOsmedeus - A Modern Orchestration Engine for Security\u003c/strong\u003e\n\n  \u003cp align=\"center\"\u003e\n  \u003ca href=\"https://docs.osmedeus.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Documentation-0078D4?style=for-the-badge\u0026logo=GitBook\u0026logoColor=39ff14\u0026labelColor=black\u0026color=black\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://docs.osmedeus.org/donation/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Sponsors-0078D4?style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=39ff14\u0026labelColor=black\u0026color=black\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://twitter.com/OsmedeusEngine\"\u003e\u003cimg src=\"https://img.shields.io/badge/%40OsmedeusEngine-0078D4?style=for-the-badge\u0026logo=Twitter\u0026logoColor=39ff14\u0026labelColor=black\u0026color=black\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://discord.gg/gy4SWhpaPU\"\u003e\u003cimg src=\"https://img.shields.io/badge/Discord%20Server-0078D4?style=for-the-badge\u0026logo=Discord\u0026logoColor=39ff14\u0026labelColor=black\u0026color=black\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/j3ssie/osmedeus/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/release/j3ssie/osmedeus?style=for-the-badge\u0026labelColor=black\u0026color=2fc414\u0026logo=Github\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n## What is Osmedeus?\n\n[Osmedeus](https://www.osmedeus.org) 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.\n\nBuilt for both beginners and experts, it delivers powerful, composable automation without sacrificing the integrity and safety of your infrastructure.\n\n## Features\n\n- **Declarative YAML Workflows** - Define reconnaissance pipelines using simple, readable YAML syntax\n- **Two Workflow Types** - Modules for single execution units, Flows for multi-module orchestration\n- **Multiple Runners** - Execute on local host, Docker containers, or remote machines via SSH\n- **Distributed Execution** - Scale with Redis-based master-worker pattern for parallel scanning\n- **Event-Driven Triggers** - Cron scheduling, file watching, and event-based workflow triggers with deduplication\n- **Decision Routing** - Conditional workflow branching with switch/case syntax\n- **Template Engine** - Powerful variable interpolation with built-in and custom variables\n- **Utility Functions** - Rich function library with event generation, bulk processing, and JSON operations\n- **REST API Server** - Manage and trigger workflows programmatically\n- **Database Support** - SQLite (default) and PostgreSQL for asset tracking\n- **Notifications** - Telegram bot and webhook integrations\n- **Cloud Storage** - S3-compatible storage for artifact management\n- **LLM Integration** - AI-powered workflow steps with chat completions and embeddings\n\nSee [Documentation Page](https://docs.osmedeus.org/) for more details.\n\n## Installation\n\n```bash\ncurl -sSL http://www.osmedeus.org/install.sh | bash\n```\n\nSee [Quickstart](https://docs.osmedeus.org/quickstart/) for quick setup and [Installation](https://docs.osmedeus.org/installation/) for advanced configurations.\n\n| CLI Usage | Web UI Assets | Workflow Visualization |\n|-----------|--------------|-----------------|\n| ![CLI Usage](https://raw.githubusercontent.com/osmedeus/assets/refs/heads/main/demo-images/cli-run-with-verbose-output.png) | ![Web UI Assets](https://raw.githubusercontent.com/osmedeus/assets/refs/heads/main/demo-images/web-ui-assets.png) | ![Workflow Visualization](https://raw.githubusercontent.com/osmedeus/assets/refs/heads/main/demo-images/web-ui-workflow.png) |\n\n## Quick Start\n\n```bash\n# Run a module workflow\nosmedeus run -m recon -t example.com\n\n# Run a flow workflow\nosmedeus run -f general -t example.com\n\n# Multiple targets with concurrency\nosmedeus run -m recon -T targets.txt -c 5\n\n# Dry-run mode (preview)\nosmedeus run -f general -t example.com --dry-run\n\n# Start API server\nosmedeus serve\n\n# List available workflows\nosmedeus workflow list\n\n# Query database tables\nosmedeus db list --table runs\nosmedeus db list --table event_logs --search \"nuclei\"\n\n# Evaluate utility functions\nosmedeus func eval 'log_info(\"hello\")'\nosmedeus func eval -e 'httpGet(\"https://example.com\")' -T targets.txt -c 10\n\n# Show all usage examples\nosmedeus --usage-example\n```\n\n## Docker\n\n```bash\n# Show help\ndocker run --rm j3ssie/osmedeus:latest --help\n\n# Run a scan\ndocker run --rm -v $(pwd)/output:/root/workspaces-osmedeus \\\n    j3ssie/osmedeus:latest run -f general -t example.com\n```\n\nFor more CLI usage and example commands, refer to the [CLI Reference](https://docs.osmedeus.org/getting-started/cli).\n\n\n## Core Components\n\n### Trigger\n\n| Type | Description | Use Case |\n|------|-------------|----------|\n| **Cron** | Schedule workflows at specific times | Regular scans |\n| **File Watch** | Trigger workflows when files change | Continuous monitoring |\n| **Event** | Trigger workflows based on external events | Integration with other tools |\n| **Webhook** | Trigger workflows based on HTTP requests | External system integration |\n| **Manual** | Trigger workflows manually via CLI or API | One-time tasks |\n\n### Workflows\n\n| Type | Description | Use Case |\n|------|-------------|----------|\n| **Module** | Single execution unit with sequential/parallel steps | Individual scanning tasks |\n| **Flow** | Orchestrates multiple modules with dependencies | Complete reconnaissance pipelines |\n\n### Runners\n\n| Runner | Description |\n|--------|-------------|\n| **Host** | Local machine execution (default) |\n| **Docker** | Container-based execution |\n| **SSH** | Remote machine execution |\n\n### Step Types\n\n| Type | Description |\n|------|-------------|\n| `bash` | Execute shell commands |\n| `function` | Call utility functions |\n| `foreach` | Iterate over file contents |\n| `parallel-steps` | Run multiple steps concurrently |\n| `remote-bash` | Per-step Docker/SSH execution |\n| `http` | Make HTTP requests |\n| `llm` | AI-powered processing |\n\n### Workflow Example\n\n```yaml\nkind: module\nname: demo-bash\ndescription: Demo bash steps with functions and exports\n\nparams:\n  - name: target\n    required: true\n\nsteps:\n  - name: setup\n    type: bash\n    command: mkdir -p {{Output}}/demo \u0026\u0026 echo \"{{Target}}\" \u003e {{Output}}/demo/target.txt\n    exports:\n      target_file: \"{{Output}}/demo/target.txt\"\n\n  - name: run-parallel\n    type: bash\n    parallel_commands:\n      - 'echo \"Thread 1: {{Target}}\" \u003e\u003e {{Output}}/demo/results.txt'\n      - 'echo \"Thread 2: {{Target}}\" \u003e\u003e {{Output}}/demo/results.txt'\n\n  - name: check-result\n    type: function\n    function: 'fileLength(\"{{Output}}/demo/results.txt\")'\n    exports:\n      line_count: \"output\"\n\n  - name: summary\n    type: bash\n    command: 'echo \"Processed {{Target}} with {{line_count}} lines\"'\n\n```\n\nFor writing your first workflow, refer to the [Workflow Overview](https://docs.osmedeus.org/workflows/overview).\n\n## Roadmap and Status\n\nThe high-level ambitious plan for the project, in order:\n\n|  #  | Step                                                                          | Status |\n| :-: | ----------------------------------------------------------------------------- | :----: |\n|  1  | Osmedeus Engine reforged with a next-generation architecture                  |   ✅   |\n|  2  | Flexible workflows and step types                                             |   ✅   |\n|  3  | Event-driven architectural model and the different trigger event categories   |   ✅   |\n|  4  | Beautiful UI for visualize results and workflow diagram                       |   ✅   |\n|  5  | Rewriting the workflow to adapt to new architecture and syntax                |   ⚠️   |\n|  6  | Testing more utility functions like notifications                             |   ⚠️   |\n|  7  | Generate diff reports showing new/removed/unchanged assets between runs.      |   ❌   |\n|  8  | Adding step type from cloud provider that can be run via serverless           |   ❌   |\n|  N  | Fancy features (to be discussed later)                                        |   ❌   |\n\n## Documentation\n\n| Topic                | Link                                                                                                     |\n|----------------------|----------------------------------------------------------------------------------------------------------|\n| Getting Started      | [docs.osmedeus.org/getting-started](https://docs.osmedeus.org/getting-started) |\n| CLI Usage \u0026 Examples | [docs.osmedeus.org/getting-started/cli](https://docs.osmedeus.org/getting-started/cli) |\n| Writing Workflows    | [docs.osmedeus.org/workflows/overview](https://docs.osmedeus.org/workflows/overview) |\n| Event-Driven Triggers| [docs.osmedeus.org/advanced/event-driven](https://docs.osmedeus.org/advanced/event-driven) |\n| Deployment           | [docs.osmedeus.org/deployment](https://docs.osmedeus.org/deployment) |\n| Architecture         | [docs.osmedeus.org/concepts/architecture](https://docs.osmedeus.org/concepts/architecture) |\n| Development          | [docs.osmedeus.org/development](https://docs.osmedeus.org/development) and [HACKING.md](HACKING.md) |\n| Extending Osmedeus   | [docs.osmedeus.org/development/extending-osmedeus](https://docs.osmedeus.org/development/extending-osmedeus)   |\n| Full Documentation   | [docs.osmedeus.org](https://docs.osmedeus.org) |\n\n## License\n\nOsmedeus is made with ♥ by [@j3ssie](https://twitter.com/j3ssie) and it is released under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj3ssie%2Fosmedeus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj3ssie%2Fosmedeus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj3ssie%2Fosmedeus/lists"}