---

सूचना: यह परियोजना सक्रिय रूप से विकसित हो रही है। इसमें ठोस मुख्य क्षमताएं और परीक्षण कवरेज है, और हम प्रत्येक रिलीज़ के साथ दस्तावेज़ीकरण, सुदृढ़ीकरण और सुविधा गहराई में सुधार करना जारी रखते हैं। योगदान, बग रिपोर्ट और प्रतिक्रिया का स्वागत है।

विशेषताएं

• Visual graph investigation — संस्थाओं को ड्रैग-एंड-ड्रॉप करें, इंटरैक्टिव तरीके से कनेक्शन एक्सप्लोर करें
• 20+ built-in transforms — DNS, WHOIS, SSL प्रमाणपत्र, जियोलोकेशन, वेब/ईमेल/हैश/सोशल एनरिचमेंट, और अधिक
• Transform Hub — रजिस्ट्री से समुदाय ट्रांसफॉर्म ब्राउज़ और इंस्टॉल करें
• 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 के साथ एक-कमांड डिप्लॉयमेंट

स्क्रीनशॉट

त्वरित आरंभ

पूर्वापेक्षाएँ

उपकरण	संस्करण
Python	3.14+
uv	latest
Node.js	20+
pnpm	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 को एक बाहरी 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 क्लाउड