منصوبے کے بارے میں
## یہ کیا ہے
ورلڈ مونیٹر ایک ریئل ٹائم گلوبل انٹیلی جنس ڈیش بورڈ ہے جو AI سے چلنے والی خبروں کے اگلے، جیو پولیٹیکل نگرانی اور انفراسٹرکچر ٹریکنگ کو ایک موقع شعوری انٹرفیس میں جوڑتا ہے۔ یہ ایک ہی کوڈ بیس سے بنایا گیا ہے جو کئی سائٹ ویریئنٹس بھیجتا ہے: ورلڈ، ٹیک، فنانشل، کامڈیٹی، ہپی اور انرجی۔
## دستاویزی قابلیتیں
- عالمی اور علاقائی زمروں میں مرتب خبروں کے فڈز، جنہیں AI نے مختصر reports میں تبدیل کیا ہے۔
- دوہرا نقشہ انجن: globe.gl سے بنایا گیا 3D گلوب اور deck.gl سے بنایا گیا WebGL فلیٹ نقشہ، مشترکہ نقشہ پرت کیٹلاگ کے ساتھ۔
- مختلف ویریئنٹس میں مخصوص پینل کے نفاذ کے ساتھ پینل انوینٹری۔
- عسکری، معاشی، آفت اور بڑھتی ہوئی علامتوں کا کراس اسٹريم مربوط کرنا۔
- قومی عدم استحکام انڈیکس (CII): 31 ٹیار-1 ممالک کے لیے براہ راست CII v8 اسکور، بینڈز اور تقریباً 24 گھنٹوں کی حرکت۔
- اسٹاک ایکسچینجز، کامڈیٹیز، کریپٹو اور مارکیٹ کمپوزٹ کو کور کرنے والا فنانشل ریڈار۔
- Ollama کے ذریعے مقامی AI آپریشن، بغیر API کی ضرورت؛ Groq اور OpenRouter کے ساتھ نیز Browser-side Transformers.js۔
- macOS (Apple Silicon اور Intel)، Windows اور Linux AppImage کے لیے Tauri 2 سے native ڈیسک ٹاپ ایپ۔ ایک بائنری تمام ویریئنٹس کو کور کرتی ہے، ایپ کے اندر سوئچ ہوتی ہے۔
- مقامی زبان کے فڈز اور RTL سپورٹ کے ساتھ کثیر اللسانی UI۔
## اسے چلانا
مندرجہ ذیل فوری شروع ہے: ریپوزٹری کلون کریں، `npm install` اور `npm run dev` چلائیں، پھر localhost:3000 کھولیں (پورٹ `DEV_PORT` سے اوور رائیڈ ہو سکتی ہے)۔ ایپ ظاہر ہے بغیر ماحولیاتی تغیرات کے چلتی ہے، حالانکہ خاص خصوصیت کے ڈیٹا سورسز کے لیے `.env.example` میں درج تصدیقی دستاویزات درکار ہو سکتی ہیں۔ مخصوص ویریئنٹس کے ڈیو سکرپٹس موجود ہیں (`dev:tech`, `dev:finance`, `dev:commodity`, `dev:happy`, `dev:energy`)۔ خود میزبان کے آپشنز میں Vercel، Docker اور اسٹैٹک ڈیپلائمنٹ شامل ہیں۔
## پروگرام میٹرک رسائی
براؤزر UI کے علاوہ، پروجیکٹ درج ذیل کا حوالہ دیتا ہے:
- `https://worldmonitor.app/mcp` پر MCP سرور (Streamable HTTP)، جس میں عوامی `tools/list` اور تصدیق شدہ `tools/call` ہیں، نیز Draft MCP Skills توسیع کے ذریعے شائع ایجنٹ Skills۔
- REST API `https://api.worldmonitor.app`، OpenAPI تفصیل کے ساتھ بیان کیا گیا۔
- سرکاری `worldmonitor` npm CLI جو ad hoc کے ذریعے `npx` یا global `worldmonitor` / `wm` کے طور پر انسٹال کیا جا سکتا ہے۔
- سرکاری صفر-ڈیپینڈنسی SDKs Python (`worldmonitor-sdk`)، Ruby اور Go کے لیے۔
Agent دریافت فائلیں جیسے `llms.txt`، ایجنٹ Skills مینی فیسٹ اور API کیٹلاگ بھی شائع ہیں۔
## ٹیک اسٹیک نوٹس
README میں frontend کے لیے vanilla TypeScript اور Vite؛ Tauri 2 (Rust) Node.js sidecar کے ساتھ desktop کے لیے؛ Ollama, Groq, OpenRouter اور Transformers.js AI کے لیے؛ Protocol Buffers اور sebuf HTTP annotations API contracts کے لیے؛ Vercel Edge Functions, Railway relay, Tauri اور PWA ڈیپلائمنٹ کے لیے؛ Redis (Upstash) تین لیئر کے کیچ، CDN اور service worker کے ساتھ درج ہیں۔
## ڈیٹا سورسز اور attribution
ڈیٹا جیوپولیٹکس، فنانشل، انرجی، کلیمیٹ، ایوی ایشن، سائبر، عسکری، انفراسٹرکچر اور نیوز انٹیلی جنس میں attributed upstream فراہم کنندگان سے جمع کیا جاتا ہے۔ ف्लाٹ ڈیٹا Wingbits کو دیے جانے والے credit کے ساتھ۔ ڈیٹا سورسز کیٹلاگ فراہم کنندہ، فیڈ ٹائر، لائسنس پوسچر اور کلیکشن طریقہ کو دستاویز کرتا ہے۔
## لائسنسنگ اور پروجیکٹ حالت
سورس کوڈ AGPL-3.0-only؛ ذاتی، تحقیقی، تعلیمی، خود میزبان اور تجارتی استعمال AGPL copyleft اور سورس دستیابی کی پابندیوں کے تحت اجازت یافتہ بتایا گیا ہے، نجی سورس proprietary استعمال کے لیے الگ سے تجارتی یا برانڈنگ اجازت کے ساتھ۔ پبلک ڈیپلائمنٹس اور ڈیسک ٹاپ بائنریز stable اور ایک ہی بیک لوگ سے برقرار ہیں۔ پروجیکٹ Elie Habib کی تصنیف ہے اور اپنے CONTRIBUTING guide کے مطابق حصہ داری کا خیر مقدم کرتا ہے۔
زبردست! ہر لڑکے کا خوابوں کا سافٹ ویئر، اس کے ساتھ، ایسا لگتا ہے جیسے آپ دنیا کے مالک ہیں۔