منصوبے کے بارے میں

یہ ریپوزٹری ایک Crypto MCP Server اور Hedgehog Agentic Trading Dashboard پیش کرتی ہے، جو Corax CoLAB کا تیار کردہ ایک خود مختار ہیج فنڈ AI آرکیسٹریٹر ہے۔ یہ نظام Model Context Protocol (MCP) انفراسٹرکچر پر مبنی ہے، جو کہ مقامی LLMs جیسے Claude Desktop کے لیے ایک لوکلائزڈ، AI سے چلنے والا بیک بون فراہم کرنے کے لیے ڈیزائن کیا گیا ہے تاکہ وہ ریئل ٹائم مارکیٹ ڈیٹا حاصل کریں، تکنیکی اور جذباتی تجزیہ کریں، اور خود مختار طریقے سے ٹریڈز انجام دیں۔ بنیادی امتیازی عنصر اس کا ملٹی ایجنٹ آرکیٹیکچرل نقطہ نظر ہے۔ ایک سادہ API ریپر ہونے کے بجائے، یہ نظام ایک ملٹی ایجنٹ پلے گراؤنڈ کے طور پر کام کرتا ہے جس میں کوئی موک اپ نہیں ہے اور تمام ویژولائزرز میں 100% حقیقی ڈیٹا استعمال ہوتا ہے، جو لائیو ویب سوکیٹس اور REST ڈیٹا سے چلتا ہے۔ آرکیٹیکچر مقامی طور پر JSON-RPC کمانڈز کو ملٹی پلیکس کرتا ہے اور نئے MCP ماڈیولز کے ذریعے آسان توسیع کی حمایت کرتا ہے۔ Autonomous Orchestrator Mode ایک مسلسل Observe-Analyze-Act (OODA) لوپ نافذ کرتا ہے جو 24/7 چلتا ہے۔ Observe مرحلہ تکنیکی اشارے، خبروں کے جذبات، اور آن چین ڈیٹا کے لیے متعدد MCPs سے استفسار کرتا ہے۔ Analyze مرحلہ سگنلز کا جائزہ لینے کے لیے LLMs (Gemini, Claude, یا OpenAI) استعمال کرتا ہے تاکہ ساختہ BUY, SELL, یا HOLD فیصلے تیار کیے جا سکیں۔ Act مرحلہ مقامی CCXT MCP کے ذریعے ٹریڈز انجام دیتا ہے۔ سسٹم میں ایجنٹک بیک ٹیسٹنگ بھی شامل ہے جو تاریخی OHLCV ڈیٹا پر AI پرامپٹس اور ماڈلز کو حقیقی فنڈز کو خطرے میں ڈالے بغیر محفوظ طریقے سے جانچنے کے لیے ہے، اور ایک Proof of Brain ٹریڈنگ ڈائری بھی ہے جو ہر عمل کے پیچھے موجود استدلال کی تفصیل بتانے والی جامع مارک ڈاؤن رپورٹس تیار کرتی ہے۔ ایک ٹیلیگرام کمانڈ سینٹر ریئل ٹائم الرٹس اور ریموٹ کنٹرول کی صلاحیتیں فراہم کرتا ہے، جس میں فعال AI فراہم کنندگان اور آخری فیصلوں کو دیکھنے، Proof of Brain رپورٹس حاصل کرنے، اور دستی OODA سائیکل شروع کرنے کے کمانڈز موجود ہیں۔ ڈیش بورڈ میں React Three Fiber اور متحرک ایمِسیو میٹریلز سے چلنے والی متعدد ریئل ٹائم ڈیٹا ویژولائزیشنز شامل ہیں: Dark Pool Sonar بڑی حجم کی وہیل ٹریڈز کے لیے، Flash-Crash Prediction Matrix جو CCXT آرڈر بکس کے ذریعے لیکویڈیٹی ڈرین کو ٹریک کرتی ہے، Galaxy View جو ٹاپ 50 کرپٹو کرنسیوں کو 3D میں دکھاتی ہے، AI Sentiment Word-Cloud Sphere جو ریئل ٹائم خبروں سے رجحان والے کلیدی الفاظ نکالتا ہے، Gas and Network Congestion Hologram جو ایتھریم نیٹ ورک کی بھیڑ کو دکھاتا ہے، اور Time-Machine Backtest Arena OHLCV ویژولائزیشن اور حکمت عملی سمولیشن کے لیے۔ Multi-MCP Ecosystem میں ایک درجن سے زائد MCP سرورز شامل ہیں جو ایکسچینج ٹریڈنگ اور مارکیٹ ڈیٹا (CCXT)، آن چین ڈیٹا (ETH بیلنس، ERC20، گیس کی قیمتیں)، تکنیکی تجزیہ (RSI, MACD, SMA, Bollinger Bands, Monte Carlo simulations)، پورٹ فولیو مینجمنٹ، مارکیٹ شماریات (CoinGecko)، LLM آپریشنز، نوٹیفکیشنز اور ٹیلیگرام براڈکاسٹنگ، اور Freqtrade, OctoBot, Hummingbot, اور Superalgos پلیٹ فارمز کے ساتھ انضمام کو کور کرتے ہیں۔ سسٹم Python MCP سرورز اور Node.js بیک اینڈ کے انتظام کے لیے ایک مرکزی .env کنفیگریشن فائل استعمال کرتا ہے، جس میں حفاظتی خصوصیات شامل ہیں جیسے پاس ورڈ سے محفوظ بیک اینڈ ایگزیکیوشن، فیئل کلوزڈ پیئر پابندیاں، زیادہ سے زیادہ ٹریڈ رقم کی حدیں، اور پاس ورڈ کی تصدیق کے لیے crypto.timingSafeEqual۔ آرڈرز مقامی SQLite ڈیٹا بیس میں لاگ ہوتے ہیں۔ انسٹالیشن خودکار install.sh اسکرپٹ یا دستی سیٹ اپ کے ذریعے تعاون یافتہ ہے، جس میں بیک اینڈ کے لیے systemd سروس مینجمنٹ شامل ہے۔ فرنٹ اینڈ Vite اور React کے ساتھ بنایا گیا ہے، جبکہ بیک اینڈ Node.js استعمال کرتا ہے۔ پروجیکٹ کے لیے Python 3.11+ اور Node.js 20+ درکار ہے۔ حفاظتی بہترین طریقوں پر زور دیا گیا ہے جن میں ٹیسٹنگ کے لیے ٹیسٹ نیٹ کیز کا استعمال، API کیز کو ریپوزٹری سے باہر رکھنا، نیٹ ورک تک رسائی کو مقامی LAN تک محدود کرنا، اور تصدیق شدہ ریورس پراکسیز کا نفاذ شامل ہے۔