
एक आधुनिक ऑर्केस्ट्रेशन इंजन सुरक्षा के लिए
# 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 - सुरक्षा के लिए एक आधुनिक ऑर्केस्ट्रेशन इंजन</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>
## Osmedeus क्या है?
[Osmedeus](https://www.osmedeus.org) एक सुरक्षा-केंद्रित डिक्लेरेटिव ऑर्केस्ट्रेशन इंजन है जो जटिल वर्कफ़्लो ऑटोमेशन को ऑडिट-योग्य YAML परिभाषाओं में सरल बनाता है, साथ ही एन्क्रिप्टेड डेटा हैंडलिंग, सुरक्षित क्रेडेंशियल प्रबंधन और सैंडबॉक्स्ड निष्पादन प्रदान करता है।
शुरुआती और विशेषज्ञ दोनों के लिए बनाया गया, यह आपके इंफ्रास्ट्रक्चर की अखंडता और सुरक्षा से समझौता किए बिना शक्तिशाली, कंपोज़ेबल ऑटोमेशन प्रदान करता है।
## मुख्य विशेषताएँ
- **डिक्लेरेटिव YAML वर्कफ़्लो** - हुक, निर्णय राउटिंग, मॉड्यूल एक्सक्लूज़न और कई रनर (host, Docker, SSH) में सशर्त ब्रांचिंग के साथ पाइपलाइन परिभाषित करें
- **वितरित निष्पादन** - क्यू सिस्टम, वेबहुक ट्रिगर और वर्कर्स में फ़ाइल सिंक के साथ Redis-आधारित मास्टर-वर्कर पैटर्न
- **समृद्ध फ़ंक्शन लाइब्रेरी** - nmap एकीकरण, tmux सत्र, SSH निष्पादन, TypeScript/Python स्क्रिप्टिंग, SARIF पार्सिंग और CDN/WAF वर्गीकरण सहित 80+ उपयोगिता फ़ंक्शन
- **इवेंट-ड्रिवन शेड्यूलिंग** - फ़िल्टरिंग, डीडुप्लिकेशन और विलंबित कार्य क्यू के साथ Cron, फ़ाइल-वॉच और इवेंट ट्रिगर
- **एजेंटिक LLM चरण** - सब-एजेंट ऑर्केस्ट्रेशन, मेमोरी प्रबंधन और संरचित आउटपुट के साथ टूल-कॉलिंग एजेंट लूप; साथ ही ACP सबप्रोसेस एजेंट (Claude Code, Codex, OpenCode, Gemini)
- **क्लाउड इंफ्रास्ट्रक्चर** - लागत नियंत्रण और स्वचालित सफ़ाई के साथ DigitalOcean, AWS, GCP, Linode और Azure पर स्कैन प्रोविज़न और चलाएँ
- **समृद्ध CLI इंटरफ़ेस** - इंटरैक्टिव डेटाबेस क्वेरी, बल्क फ़ंक्शन मूल्यांकन, वर्कफ़्लो लिंटिंग, प्रगति बार और व्यापक उपयोग उदाहरण
- **REST API और Web UI** - वेबहुक ट्रिगर, डेटाबेस क्वेरी और विज़ुअलाइज़ेशन के लिए एम्बेडेड डैशबोर्ड के साथ पूर्ण API सर्वर
अधिक जानकारी के लिए [दस्तावेज़ीकरण पृष्ठ](https://docs.osmedeus.org/) देखें।
## इंस्टॉलेशन
```bash
curl -sSL http://www.osmedeus.org/install.sh | bash
```
### [npm](https://www.npmjs.com/package/@j3ssie/osmedeus)
```bash
npm install -g @j3ssie/osmedeus
```
linux और macOS पर x64/arm64 के लिए पहले से बने बाइनरीज़ उपलब्ध हैं।
त्वरित सेटअप के लिए [Quickstart](https://docs.osmedeus.org/quickstart/) देखें और उन्नत कॉन्फ़िगरेशन के लिए [Installation](https://docs.osmedeus.org/installation/) देखें।
| CLI उपयोग | Web UI एसेट्स |
|-----------|---------------|
|  |  |
| **वर्कफ़्लो विज़ुअलाइज़ेशन** | **कमज़ोरियाँ** |
|  |  |
## ☁️ प्रायोजक — Bloome
[](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607)
Osmedeus के साथ रेकॉन को स्वचालित कर रहे हैं? [Bloome](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607) उसी टीम-ऑफ़-एजेंट्स मानसिकता को आपके बाकी वर्कफ़्लो में लाता है: कई AI एजेंट्स (Claude, ChatGPT, DeepSeek और अन्य) एक साझा चैट में जो काम बाँटते हैं, कार्य एक-दूसरे को सौंपते हैं, एक-दूसरे की जाँच करते हैं, और आउटपुट को सही होने तक परिष्कृत करते हैं — निष्कर्षों की ट्राइएज करना, रिपोर्ट का मसौदा तैयार करना, और निर्धारित जाँचें एक साथ चलाना। शून्य सेटअप, क्लाउड में, वेब और मोबाइल पर, और आपकी टीम के साथ साझा करने योग्य। 👉 [Bloome आज़माएँ](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607)
## त्वरित शुरुआत
```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
```
अधिक CLI उपयोग और उदाहरण कमांड के लिए, [CLI Reference](https://docs.osmedeus.org/getting-started/cli) देखें।
## उच्च-स्तरीय आर्किटेक्चर
```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 │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└───────────────────────────────────────────────────────────────────────────┘
```
अधिक जानकारी के लिए, [Architecture Documentation](https://docs.osmedeus.org/architecture) देखें।
## रोडमैप और स्थिति
परियोजना की उच्च-स्तरीय महत्वाकांक्षी योजना, क्रम में:
| # | चरण | स्थिति |
| :-: | --------------------------------------------------------------------------- | :----: |
| 1 | Osmedeus Engine को अगली पीढ़ी की आर्किटेक्चर के साथ फिर से तैयार किया गया | ✅ |
| 2 | लचीले वर्कफ़्लो और चरण प्रकार | ✅ |
| 3 | इवेंट-संचालित आर्किटेक्चरल मॉडल और विभिन्न ट्रिगर इवेंट श्रेणियाँ | ✅ |
| 4 | परिणामों और वर्कफ़्लो आरेख को देखने के लिए सुंदर UI | ✅ |
| 5 | नई आर्किटेक्चर और सिंटैक्स के अनुकूल होने के लिए वर्कफ़्लो को फिर से लिखना | ✅ |
| 6 | अधिक उपयोगिता फ़ंक्शन जैसे सूचनाओं का परीक्षण | ✅ |
| 7 | SARIF पार्सिंग के साथ SAST एकीकरण (Semgrep, Trivy, आदि) | ✅ |
| 8 | क्लाउड एकीकरण, जो क्लाउड प्रदाता पर स्कैन चलाने का समर्थन करता है। | ✅ |
| 9 | रनों के बीच नए/हटाए गए/अपरिवर्तित एसेट दिखाने वाली डिफ़ रिपोर्ट तैयार करना। | ❌ |
| 10 | क्लाउड प्रदाता से चरण प्रकार जोड़ना जिसे सर्वरलेस के माध्यम से चलाया जा सके | ❌ |
| N | शानदार सुविधाएँ (बाद में चर्चा की जाएगी) | ❌ |
## दस्तावेज़ीकरण
| विषय | लिंक |
|----------------------|----------------------------------------------------------------------------------------------------------|
| शुरुआत करना | [docs.osmedeus.org/getting-started](https://docs.osmedeus.org/getting-started) |
| CLI उपयोग और उदाहरण | [docs.osmedeus.org/getting-started/cli](https://docs.osmedeus.org/getting-started/cli) |
| वर्कफ़्लो लिखना | [docs.osmedeus.org/workflows/overview](https://docs.osmedeus.org/workflows/overview) |
| इवेंट-संचालित ट्रिगर| [docs.osmedeus.org/advanced/event-driven](https://docs.osmedeus.org/advanced/event-driven) |
| परिनियोजन | [docs.osmedeus.org/deployment](https://docs.osmedeus.org/deployment) |
| आर्किटेक्चर | [docs.osmedeus.org/concepts/architecture](https://docs.osmedeus.org/concepts/architecture) |
| विकास | [docs.osmedeus.org/development](https://docs.osmedeus.org/development) और [HACKING.md](https://github.com/j3ssie/osmedeus/blob/main/HACKING.md) |
| Osmedeus का विस्तार | [docs.osmedeus.org/development/extending-osmedeus](https://docs.osmedeus.org/development/extending-osmedeus) |
| सुरक्षा मॉडल | [SECURITY.md](https://github.com/j3ssie/osmedeus/blob/main/SECURITY.md) और [docs.osmedeus.org/others/security-warning](https://docs.osmedeus.org/others/security-warning) |
| पूर्ण दस्तावेज़ीकरण | [docs.osmedeus.org](https://docs.osmedeus.org) |
## अस्वीकरण
**Osmedeus** को CLI, API और वर्कफ़्लो परिभाषाओं के माध्यम से उपयोगकर्ता द्वारा दिए गए इनपुट से मनमाना कोड और कमांड निष्पादित करने के लिए डिज़ाइन किया गया है। यह लचीलापन जानबूझकर है और इंजन के संचालन के तरीके का केंद्रीय हिस्सा है।
सुरक्षित रहने के तरीके के बारे में अधिक जानकारी के लिए कृपया [⚠️ Security Warning](https://docs.osmedeus.org/others/security-warning) पृष्ठ देखें। [SECURITY.md](https://github.com/j3ssie/osmedeus/blob/main/SECURITY.md) जानबूझकर किए गए कोड निष्पादन और जो भेद्यता माना जाता है, के बीच की रेखा खींचता है, और यदि आप कोई भेद्यता रिपोर्ट करना चाहते हैं तो यहीं से शुरुआत करें।
**दो बार सोचें इससे पहले कि आप:**
- अविश्वसनीय स्रोतों से डाउनलोड किए गए वर्कफ़्लो चलाएँ
- ऐसे लक्ष्यों के विरुद्ध कमांड या स्कैन निष्पादित करें जिनके आप स्वामी नहीं हैं या जिनका परीक्षण करने की अनुमति आपके पास नहीं है
- वर्कफ़्लो की सामग्री की पहले समीक्षा किए बिना उनका उपयोग करें
आप जो चलाते हैं उसके लिए आप ज़िम्मेदार हैं। निष्पादन से पहले हमेशा वर्कफ़्लो YAML फ़ाइलों की समीक्षा करें, विशेष रूप से तृतीय पक्षों से प्राप्त की गई फ़ाइलों की।
## लाइसेंस
Osmedeus को ♥ के साथ [@j3ssie](https://twitter.com/j3ssie) द्वारा बनाया गया है और यह MIT लाइसेंस के अंतर्गत जारी किया गया है।