मुक्त स्रोत लिंक विश्लेषण और OSINT फ्रेमवर्क
<div align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12241/4d60ae367bb5f1d9b7d1d95df2b16186f01454c9610e40703f636923a0a70ced.png" alt="OGI Mascot" width="200" /> # OpenGraph Intel (OGI) **ओपन-सोर्स विज़ुअल लिंक विश्लेषण और OSINT ढांचा।** **मुफ़्त, स्व-होस्ट करने योग्य, और समुदाय-संचालित।** [](https://www.gnu.org/licenses/agpl-3.0) [](https://github.com/khashashin/ogi/actions/workflows/ci.yml) [](https://github.com/khashashin/ogi/actions/workflows/docker-publish.yml) [](https://www.python.org) [](https://www.typescriptlang.org) [](https://react.dev) [](https://fastapi.tiangolo.com)  [विशेषताएं](#features) • [स्क्रीनशॉट](#screenshots) • [त्वरित आरंभ](#quick-start) • [डॉकर](#docker) • [ट्रांसफॉर्म हब](#transform-hub) • [आर्किटेक्चर](#architecture) • [योगदान](#contributing) </div> --- > **सूचना:** यह परियोजना सक्रिय रूप से विकसित हो रही है। इसमें ठोस मुख्य क्षमताएं और परीक्षण कवरेज है, और हम प्रत्येक रिलीज़ के साथ दस्तावेज़ीकरण, सुदृढ़ीकरण और सुविधा गहराई में सुधार करना जारी रखते हैं। योगदान, बग रिपोर्ट और प्रतिक्रिया का स्वागत है। ## विशेषताएं - **Visual graph investigation** — संस्थाओं को ड्रैग-एंड-ड्रॉप करें, इंटरैक्टिव तरीके से कनेक्शन एक्सप्लोर करें - **20+ built-in transforms** — DNS, WHOIS, SSL प्रमाणपत्र, जियोलोकेशन, वेब/ईमेल/हैश/सोशल एनरिचमेंट, और अधिक - **Transform Hub** — [रजिस्ट्री](https://github.com/opengraphintel/ogi-transforms) से समुदाय ट्रांसफॉर्म ब्राउज़ और इंस्टॉल करें - **AI Investigator** — प्रॉम्प्ट-संचालित एजेंटिक जांच जो ट्रांसफॉर्म रन की योजना बनाती है, लाइव प्रगति स्ट्रीम करती है, और ऑडिटेबिलिटी के साथ निष्कर्षों का सारांश प्रस्तुत करती है - **Import / Export** — JSON, CSV, GraphML, और MTGX प्रारूप आयात - **Graph analysis** — केंद्रीयता, समुदाय का पता लगाना, सबसे छोटे रास्ते - **Real-time collaboration** — प्रोजेक्ट, साझाकरण, और Supabase Realtime के माध्यम से लाइव सिंक - **Async transform jobs** — Redis/RQ कतार WebSocket प्रगति अपडेट के साथ - **Plugin system** — YAML मेनिफेस्ट के साथ निर्देशिका-आधारित प्लगइन खोज - **CLI tool** — टर्मिनल से ट्रांसफॉर्म खोजें, इंस्टॉल करें और प्रबंधित करें - **Runs anywhere** — स्थानीय SQLite मोड (शून्य कॉन्फ़िगरेशन) या टीम/क्लाउड सेटअप के लिए PostgreSQL + Supabase - **Docker ready** — `docker compose up` के साथ एक-कमांड डिप्लॉयमेंट ## स्क्रीनशॉट <div align="center"> | Graph Investigation | Entity Enrichment | | :-------------------------------------------: | :-----------------------------------------: | |  |  | | Transform Hub | Export / Import | | :-------------------------------------: | :-------------------------------------: | |  |  | </div> ## त्वरित आरंभ ### पूर्वापेक्षाएँ | उपकरण | संस्करण | | -------------------------------- | ------- | | [Python](https://www.python.org) | 3.14+ | | [uv](https://docs.astral.sh/uv/) | latest | | [Node.js](https://nodejs.org) | 20+ | | [pnpm](https://pnpm.io) | latest | ### बैकएंड```bash cd backend uv sync uv run uvicorn ogi.main:app --reload ``` The API will be available at `http://localhost:8000`. For local transform execution, Redis and the transform worker must also be running. Redis alone is not enough. Start Redis:```bash docker run -d --name ogi-redis -p 6379:6379 redis:7-alpine ``` दूसरे टर्मिनल में ट्रांसफॉर्म वर्कर शुरू करें:```bash cd backend uv run python -m ogi.worker.run_worker ``` यदि आप `Job queue not available` या `Redis not available` देखते हैं, तो सुनिश्चित करें कि: - `OGI_REDIS_URL` स्थानीय होस्ट-आधारित रन के लिए `redis://localhost:6379/0` को इंगित करता है - Redis आने के बाद बैकएंड को पुनरारंभ किया गया था - अलग वर्कर प्रक्रिया चल रही है - आप Docker Compose के बाहर Docker-केवल होस्टनाम `redis` का उपयोग नहीं कर रहे हैं यदि आप PostgreSQL (`OGI_USE_SQLITE=false`) के विरुद्ध बैकएंड चलाते हैं, तो स्टार्टअप अनुरोधों को सेवा देने से पहले स्वचालित रूप से Alembic माइग्रेशन लागू करेगा। Docker डिप्लॉयमेंट बैकएंड कंटेनर एंट्रीपॉइंट में भी ऐसा ही करते हैं। AI Investigator रन एक अन्य अलग वर्कर द्वारा संसाधित किए जाते हैं:```bash cd backend uv run python -m ogi.agent.run_worker ``` ### फ्रंटएंड```bash cd frontend pnpm install pnpm dev ``` Open http://localhost:5173। बस इतना ही। ### AI जाँचकर्ता AI जाँचकर्ता एक वैकल्पिक प्रदाता-समर्थित कार्यप्रवाह है जो कार्यक्षेत्र के अंदर ट्रांसफ़ॉर्म अनुक्रमों की योजना बना सकता है, अनुमोदन का अनुरोध कर सकता है, और जांच प्रगति का सारांश प्रस्तुत कर सकता है। - किसी प्रोजेक्ट के अंदर `AI जाँचकर्ता` टैब खोलें - जाँचकर्ता सेटिंग्स डायलॉग में एक प्रदाता और मॉडल कॉन्फ़िगर करें - `API कुंजियाँ` में प्रदाता API कुंजियाँ संग्रहीत करें - बैकएंड के साथ अलग `agent-worker` प्रक्रिया चलाएँ वर्तमान कार्यान्वयन प्रति-उपयोगकर्ता प्रदाता कॉन्फ़िगरेशन और एक समर्पित वर्कर का समर्थन करता है जो मुख्य API सर्वर से स्वतंत्र रूप से जांच चरणों को निष्पादित करता है। ### CLI CLI चलाने के दो समर्थित तरीके: **अनुशंसित** (कोई सक्रियण आवश्यक नहीं):```bash cd backend uv sync uv run ogi --help ``` **सक्रिय virtualenv** (सादा `ogi` कमांड):```bash cd backend uv venv # PowerShell: .\.venv\Scripts\Activate.ps1 uv pip install -e . ogi --help ``` ## Docker ### डेवलपमेंट```bash cp .env.example .env docker compose up ``` ### उत्पादन पूर्व-निर्मित GHCR इमेज का उपयोग करें। महत्वपूर्ण: [docker-compose.prod.yml](https://github.com/khashashin/ogi/blob/main/docker-compose.prod.yml) को एक बाहरी PostgreSQL डेटाबेस की आवश्यकता है। इसमें `db` सेवा शामिल नहीं है। यदि आप अंतर्निर्मित Postgres और Redis के साथ ऑल-इन-वन स्थानीय Docker स्टैक चाहते हैं, तो उपयोग करें:```bash docker compose up -d ``` प्रोडक्शन कंपोज़ फ़ाइल का उपयोग केवल तब करें जब आपके पास पहले से एक सुलभ PostgreSQL इंस्टेंस हो और आपने `OGI_DATABASE_URL` को तदनुसार सेट किया हो:```bash docker compose -f docker-compose.prod.yml pull docker compose -f docker-compose.prod.yml up -d ``` सेट करें `OGI_IMAGE_TAG` को `.env` में एक विशिष्ट रिलीज़ इमेज टैग (जैसे `v0.2.6`) को पिन करने के लिए। डिफ़ॉल्ट `latest` है। ### Hetzner क्लाउड [](https://hetzner.cloud/?ref=LspEGc99USBa) [](https://console.hetzner.com/deploy/docker-ce) नए Hetzner उपयोगकर्ता पहले लिंक का उपयोग करके Hetzner क्लाउड क्रेडिट के साथ साइन अप कर सकते हैं। यह एक रेफरल लिंक है, इसलिए यदि रेफरल योग्य है तो OGI रखरखावकर्ता को भी Hetzner क्लाउड क्रेडिट प्राप्त हो सकते हैं। सर्वर बनाने के बाद, OGI चलाने के लिए ऊपर दिए गए Docker तैनाती कमांड का उपयोग करें। ### अनुकूलन योग्य ट्रांसफ़ॉर्म सीमाएं OGI `max_results`, `max_links`, `max_urls`, और `max_content_chars` जैसी चीज़ों के लिए उचित प्रति-ट्रांसफ़ॉर्म अधिकतम मानों के साथ आता है, लेकिन अब उन सीमाओं को केंद्रीय रूप से ओवरराइड किया जा सकता है ताकि क्लाउड डिप्लॉयमेंट स्थानीय सीमाओं को हार्डकोड किए बिना उन्हें लागू कर सकें। `.env` में `OGI_TRANSFORM_SETTING_MAX_OVERRIDES` का उपयोग करें:```env OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=50,max_urls=25,max_links=40,max_content_chars=20000 ``` स्थानीय-प्रथम तैनाती में विशिष्ट सीमाओं को हटाने के लिए:```env OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=none,max_urls=none,max_links=none,max_content_chars=none ``` की-ओवरराइड ट्रांसफॉर्म सेटिंग नाम से की गई है और यह बिल्ट-इन ट्रांसफॉर्म और सामुदायिक प्लगइन्स पर लागू होती है जो OGI के साझा ट्रांसफॉर्म बेस/रनटाइम का उपयोग करते हैं। ### होस्टेड क्लाउड इंस्टेंस और सपोर्टर योजना [ogi.khas.app](https://ogi.khas.app) पर होस्टेड क्लाउड संस्करण शुरू में इसलिए बनाया गया था ताकि उपयोगकर्ता स्वयं-होस्ट करने का निर्णय लेने से पहले OGI को तुरंत आज़मा सकें। यह अब परियोजना का उपयोग करने का सबसे लोकप्रिय तरीका बन गया है, जिसमें 350 से अधिक सक्रिय क्लाउड उपयोगकर्ता हैं। इस उपयोग ने इस साइड प्रोजेक्ट के लिए बुनियादी ढांचे की लागत भी बढ़ा दी। इसलिए रिपॉजिटरी में एक क्लाउड-केवल सपोर्टर सब्सक्रिप्शन और ट्रांसफॉर्मर रन कूलडाउन सिस्टम शामिल है। सार्वजनिक क्लाउड इंस्टेंस पर, मुफ्त उपयोगकर्ता ट्रांसफॉर्मर रन के बीच टाइमआउट द्वारा सीमित हो सकते हैं, जबकि सपोर्टर उपयोगकर्ता सुपाबेस और VPS लागतों को कवर करने में मदद करने के लिए प्रतीकात्मक USD 3/माह की सदस्यता ले सकते हैं। सपोर्टर सब्सक्रिप्शन को प्रोफाइल बिलिंग नियंत्रण या स्ट्राइप बिलिंग पोर्टल से रद्द किया जा सकता है। रद्द करने से भविष्य का बिलिंग रुक जाता है, लेकिन भुगतान की गई सदस्यता अवधि वापस नहीं की जाती या आनुपातिक नहीं की जाती। यह बिलिंग कोड जानबूझकर कॉन्फ़िगरेशन द्वारा संरक्षित है: इसका प्रभाव केवल तब होता है जब `OGI_DEPLOYMENT_MODE=cloud` और `OGI_CLOUD_BILLING_ENABLED=true` हो। स्वयं-होस्टेड डिप्लॉयमेंट को बिलिंग अक्षम छोड़ देना चाहिए और उन्हें कोई बिलिंग या पेवॉल व्यवहार नहीं दिखना चाहिए। ### टेलीमेट्री OGI में इंस्टॉलेशन-स्तरीय उत्पाद टेलीमेट्री शामिल है जो हमें वास्तविक दुनिया के उपयोग, विशेष रूप से स्वयं-होस्टेड डिप्लॉयमेंट में, को समझने में मदद करने के लिए है। - `OGI_TELEMETRY_ENABLED=true` टेलीमेट्री संग्रह सक्षम करता है - `OGI_TELEMETRY_LEVEL=full` डिफ़ॉल्ट संग्रह स्तर है - टेलीमेट्री को पूरी तरह से अक्षम करने के लिए `OGI_TELEMETRY_ENABLED=false` सेट करें - भेजी गई चीज़ों को कम करने के लिए `OGI_TELEMETRY_LEVEL=basic` सेट करें `basic` भेजता है: - OGI संस्करण - एक दैनिक सक्रिय इंस्टॉलेशन पिंग `full` इसके अतिरिक्त भेजता है: - इंस्टेंस निर्मित तिथि - अवधि के लिए प्रोजेक्ट्स, संस्थाओं, किनारों, ट्रांसफॉर्म रन, अन्वेषक रन और सक्रिय उपयोगकर्ताओं की कुल संख्या - उनके संस्करणों के साथ स्थापित ट्रांसफॉर्म टेलीमेट्री को ग्राफ सामग्री, इकाई मान, API कुंजी, प्रॉम्प्ट या अन्य जांच डेटा भेजने से बचने के लिए डिज़ाइन किया गया है। वर्तमान नीति विवरण [गोपनीयता नीति](https://ogi.khas.app/privacy#telemetry) में भी प्रकाशित हैं। <details> <summary><strong>डेवलपमेंट कम्पोज़ सेवाएँ</strong></summary> | सेवा | विवरण | पोर्ट | | -------------- | ------------------------- | ---- | | `backend` | FastAPI एप्लिकेशन सर्वर | 8000 | | `worker` | RQ एसिंक जॉब वर्कर | - | | `agent-worker` | AI अन्वेषक वर्कर | - | | `frontend` | nginx के माध्यम से React ऐप | 80 | | `db` | PostgreSQL 16 | 5432 | | `redis` | Redis 7 (जॉब कतार) | 6379 | </details> <details> <summary><strong>प्रोडक्शन कम्पोज़ सेवाएँ</strong></summary> | सेवा | विवरण | पोर्ट | | -------------- | ------------------------- | ---- | | `backend` | FastAPI एप्लिकेशन सर्वर | 8000 | | `worker` | RQ एसिंक जॉब वर्कर | - | | `agent-worker` | AI अन्वेषक वर्कर | - | | `frontend` | nginx के माध्यम से React ऐप | 80 | | `redis` | Redis 7 (जॉब कतार) | 6379 | `docker-compose.prod.yml` `OGI_DATABASE_URL` के माध्यम से एक बाहरी PostgreSQL डेटाबेस की अपेक्षा करता है। </details> --- <details> <summary><strong>बूट-टाइम प्लगइन निर्भरताएँ</strong></summary> यदि आप पूर्व-निर्मित इमेज का उपयोग करते हैं और एक प्लगइन को अतिरिक्त Python लाइब्रेरी की आवश्यकता है, तो OGI कंटेनर स्टार्टअप पर प्लगइन निर्भरताएँ स्थापित करता है: 1. `plugins/requirements.txt` (पसंदीदा), या 2. जब `requirements.txt` गायब हो तो `plugins/ogi-lock.json` से व्युत्पन्न स्वचालित रूप से उत्पन्न आवश्यकताएँ। **पर्यावरण चर:** | चर | डिफ़ॉल्ट | विवरण | | ------------------------------------ | -------------------------------- | ----------------------------------------- | | `OGI_BOOT_REQUIREMENTS_ENABLE` | `true` | बूट-टाइम इंस्टॉल सक्षम/अक्षम करें | | `OGI_BOOT_REQUIREMENTS_FILE` | `/app/plugins/requirements.txt` | आवश्यकताएँ फ़ाइल का पथ | | `OGI_BOOT_LOCK_FILE` | `/app/plugins/ogi-lock.json` | लॉक फ़ाइल का पथ | | `OGI_BOOT_REQUIREMENTS_STRICT` | `false` | यदि आवश्यकताएँ गायब हों तो स्टार्टअप विफल | | `OGI_BOOT_REQUIREMENTS_CACHE_DIR` | `/tmp/ogi-boot` | उत्पन्न आवश्यकताओं के लिए टेम्प/कैश निर्देशिका | </details> --- ## ट्रांसफॉर्म हब OpenGraph Intel में एक अंतर्निहित ट्रांसफॉर्म बाज़ार है। [सामुदायिक रजिस्ट्री](https://github.com/opengraphintel/ogi-transforms) से ट्रांसफॉर्म ब्राउज़ करें, इंस्टॉल करें और प्रबंधित करें। > **सुरक्षा नोट:** जिन प्लगइन्स को API कुंजियों की आवश्यकता होती है, उन्हें विशेषाधिकार प्राप्त कोड के रूप में माना जाना चाहिए। यदि कोई प्लगइन आपके रहस्यों तक पहुँच सकता है और आउटबाउंड नेटवर्क अनुरोध कर सकता है, तो वह उन रहस्यों का दुरुपयोग या निकासी कर सकता है। तृतीय-पक्ष प्लगइन्स को स्थापित या चलाने से पहले विश्वास स्तर, अनुमतियाँ और आवश्यक सेवाओं की समीक्षा करें।```bash # Search for transforms uv run ogi transform search dns # Install a transform uv run ogi transform install shodan-host-lookup ``` ### निर्मित ट्रांसफॉर्म श्रेणियाँ | श्रेणी | उदाहरण | | --------- | ------------------------------------- | | DNS | A, AAAA, MX, NS, CNAME रिकॉर्ड | | IP और ASN | GeoIP, रिवर्स IP, ASN जानकारी | | SSL/TLS | प्रमाणपत्र पारदर्शिता, SSL लैब्स | | ईमेल | मेलसर्वर सत्यापन, उल्लंघन जाँच | | वेब | WHOIS, डोमेन जानकारी, वेब निष्कर्षण | | सोशल | उपयोगकर्ता नाम गणना, सोशल प्रोफाइल | | हैश | MD5, SHA1, SHA256 लुकअप | | स्थान | जियोकोडिंग, मौसम, निकटवर्ती ASN डेटा | ### समर्थित एंटिटी प्रकार `Person` • `Username` • `Domain` • `IPAddress` • `EmailAddress` • `PhoneNumber` • `Organization` • `URL` • `SocialMedia` • `Hash` • `Document` • `Location` • `ASNumber` • `Network` • `MXRecord` • `NSRecord` • `Nameserver` • `SSLCertificate` • `Subdomain` • `HTTPHeader` ### अपने खुद के ट्रांसफॉर्म बनाना अपना खुद का बनाना चाहते हैं? [योगदान गाइड](https://github.com/opengraphintel/ogi-transforms/blob/main/CONTRIBUTING.md) देखें। अगर आपके ट्रांसफॉर्म को बाहरी सेवा क्रेडेंशियल्स की आवश्यकता है, तो उन्हें `api_keys_required` में घोषित करें। ट्रांसफॉर्म सेटिंग्स में रहस्य संग्रहित न करें। OGI उन्हें `API Keys` के अंतर्गत प्रबंधित करता है, और रहस्य-उपयोग करने वाले प्लगइन्स विशेषाधिकार प्राप्त कोड माने जाते हैं। अगर आपका ट्रांसफॉर्म सीमित सेटिंग्स जैसे `max_results` या `max_content_chars` को उजागर करता है, तो जहां संभव हो, अनुकूलित एक-बार के नामों के बजाय स्थिर सेटिंग नामों को प्राथमिकता दें। OGI `OGI_TRANSFORM_SETTING_MAX_OVERRIDES` के साथ केंद्रीय रूप से अधिकतम मानों को ओवरराइड कर सकता है, जो क्लाउड डिप्लॉयमेंट को सीमाएं लागू करने में मदद करता है जबकि स्थानीय उपयोगकर्ता उन्हें हटा सकते हैं। प्रत्येक प्लगइन एक निर्देशिका है जिसमें `plugin.yaml` मैनिफेस्ट है:```yaml name: my-transform version: "1.0.0" display_name: My Transform description: What it does author: Your Name license: MIT category: dns input_types: [Domain] output_types: [IPAddress] permissions: network: true filesystem: false subprocess: false ``` ## आर्किटेक्चर ### तकनीकी स्टैक | परत | प्रौद्योगिकी | | ----------------------- | ------------------------------------------------------------------------- | | बैकएंड | Python 3.14+, FastAPI, SQLModel, asyncpg / aiosqlite | | फ्रंटएंड | React 19, TypeScript 5.9, Sigma.js (graphology), Zustand, Tailwind CSS 4 | | डेटाबेस | PostgreSQL 16 (primary) / SQLite (local fallback) | | प्रमाणीकरण और रीयलटाइम | Supabase Auth + JWT + Realtime (optional in local mode) | | कार्य कतार | Redis 7 + RQ (async transforms) | | AI रनटाइम | Provider-backed AI Investigator worker with audited transform orchestration | | पैकेज प्रबंधक | uv (backend), pnpm (frontend) | | तैनाती | Docker, nginx, GHCR | ### परियोजना संरचना``` ogi/ ├── backend/ │ └── ogi/ │ ├── api/ # REST API routes │ ├── cli/ # CLI tool (Typer) │ ├── db/ # Database layer (asyncpg + aiosqlite) │ ├── engine/ # Graph engine & transform engine │ ├── models/ # SQLModel definitions │ ├── store/ # Data stores │ ├── transforms/ # Built-in transforms │ │ ├── dns/ # DNS resolution transforms │ │ ├── cert/ # SSL certificate transforms │ │ ├── email/ # Email enrichment │ │ ├── hash/ # Hash lookups │ │ ├── ip/ # IP/ASN/geolocation │ │ ├── org/ # Organization info │ │ ├── social/ # Social media │ │ └── web/ # Web scraping/extraction │ ├── worker/ # Async job queue (RQ) │ ├── config.py # Pydantic settings │ └── main.py # FastAPI entry point ├── frontend/ │ └── src/ │ ├── api/ # API client │ ├── components/ # React components │ ├── hooks/ # Custom hooks (realtime sync, etc.) │ ├── stores/ # Zustand state management │ ├── types/ # TypeScript types │ └── App.tsx # Main application ├── plugins/ # Community plugins directory ├── docs/ # Documentation & images ├── docker-compose.yml # Development deployment ├── docker-compose.prod.yml # Production deployment └── .env.example # Environment template ``` ### कॉन्फ़िगरेशन OGI [pydantic-settings](https://docs.pydantic.dev/latest/concepts/pydantic_settings/) के साथ `.env` फ़ाइल समर्थन का उपयोग करता है। रनटाइम/बैकएंड वेरिएबल `OGI_` से उपसर्गित होते हैं। सूची-शैली सेटिंग्स या तो स्वीकार करती हैं: - JSON arrays, for example `["plugins","../plugins"]` - comma-separated strings, for example `plugins,../plugins` <details> <summary><strong>मुख्य पर्यावरण चर</strong></summary> | Variable | विवरण | डिफ़ॉल्ट | ``` --- [Read more](https://github.com/khashashin/ogi)
