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

Hippo AI کوڈنگ ایجنٹس کے لیے ایک میموری پرت ہے، جو npm پیکج `hippo-memory` کے طور پر تقسیم کیا جاتا ہے۔ اس کا بیان کردہ اصول یہ ہے کہ اچھی یادداشت کا مطلب یہ جاننا ہے کہ کیا بھولنا ہے: جو یادیں غلط ثابت ہوئیں، تبدیل ہوئیں، یا کبھی استعمال نہیں ہوئیں انہیں کم درجہ دینا چاہیے یا مکمل طور پر یادداشت سے خارج کر دینا چاہیے۔ یہ MIT لائسنس یافتہ ہے اور Node.js 22.16+ کی ضرورت ہے۔ ذخیرہ اور بازیافت یادیں مقامی SQLite ڈیٹا بیس `.hippo/hippo.db` میں رہتی ہیں، ہر تبدیلی کے بعد مارک ڈاؤن آئینے لکھے جاتے ہیں تاکہ اسٹور انسانی پڑھنے کے قابل اور git ٹریک ایبل ہو۔ تلاش بطور ڈیفالٹ BM25 ہے، بغیر کسی ماڈل اور نیٹ ورک کال کے؛ ایمبیڈنگز اختیاری انسٹال ہیں (مقامی Transformers.js، یا OpenAI، Voyage یا Cohere سے اختیاری API ایمبیڈرز)۔ پروجیکٹ صفر رن ٹائم ڈیپنڈنسیز کی اطلاع دیتا ہے۔ ایک MCP سرور اور HTTP API اسٹور کو کسی بھی مطابقت رکھنے والے کلائنٹ تک رسائی فراہم کرتے ہیں۔ نتائج سے سیکھنا دو میکانزم کو ماپا گیا ہے: یادداشت کو غلط نشان زد کرنے سے اس کی درجہ بندی کم ہوتی ہے، اور بار بار استعمال یادداشت کو مضبوط کرتا ہے۔ `hippo supersede` تبدیل شدہ حقیقت کو یادداشت سے خارج کر دیتا ہے۔ غلطی سے ٹیگ شدہ یادیں عام یادوں کی نسبت دوگنی نصف زندگی حاصل کرتی ہیں۔ ڈیفالٹ نصف زندگی 365 دن ہے؛ README ایک پہلے سے رجسٹرڈ تشخیص کا ذکر کرتا ہے جہاں 7 دن موجودہ ورژن کی حقیقت کو زیادہ کثرت سے کھو دیتے ہیں، جبکہ 730 دن اور ڈیکیے آف 365 کے ساتھ برابر رہے۔ ڈیکیے، تین پرت ذخیرہ اور نیند انضمام کو ہپپوکیمپس سے متاثر بیان کیا گیا ہے، اور README کہتا ہے کہ ان کے ٹیسٹوں میں ڈیکیے ڈس ایبلڈ کے ساتھ برابر رہا اور نیند نے یادداشت کم کی۔ سیٹ اپ اور انٹیگریشنز پروجیکٹ کے اندر چلایا گیا `hippo init` `.hippo/` اسٹور بناتا ہے، موجودہ `CLAUDE.md` یا `AGENTS.md` میں نشان زد بلاک شامل کرتا ہے، پتہ چلائے گئے ایجنٹس کے لیے ہکس انسٹال کرتا ہے (Claude Code سیٹنگز، OpenCode پلگ ان، Codex `hooks.json` اندراجات جنہیں ایک بار اعتماد درکار ہوتا ہے)، اور روزانہ صبح 6:15 بجے رن شیڈول کرتا ہے۔ `hippo init --scan <folder>` تین سطحوں تک گہرے git ریپوزٹریز تلاش کرتا ہے اور ہر ایک کو پچھلے 365 دنوں کے کمٹس سے بیج دیتا ہے۔ جھنڈے `--no-hooks`، `--no-schedule` اور `--no-learn` انفرادی حصوں کو چھوڑ دیتے ہیں۔ `hippo doctor` سیٹ اپ کی تصدیق کرتا ہے۔ خصوصیات امپورٹرز ChatGPT ایکسپورٹس، CLAUDE.md، Cursor قواعد، مارک ڈاؤن اور سادہ متن کا احاطہ کرتے ہیں، ڈرائی رن اور ڈپلیکیٹ کھوج کے ساتھ۔ گفتگو کی گرفتاری پیٹرن ہیورسٹکس کے ذریعے فیصلے، قواعد، غلطیاں اور ترجیحات نکالتی ہے نہ کہ LLM کے ذریعے۔ Slack اور GitHub ویب ہک کنیکٹرز ایونٹس کو خام یادوں کے طور پر ماخذ اور حذف کی ہینڈلنگ کے ساتھ داخل کرتے ہیں۔ اضافی کمانڈز فعال کام کے سنیپ شاٹس، سیشن ایونٹ ٹریلز، ہینڈ آف، باؤنڈڈ ورکنگ میموری اسکریچ پیڈ، اعتماد کی سطحیں (تصدیق شدہ، مشاہدہ شدہ، تخمینی، پرانا)، تنازعہ ٹریکنگ، مائیگریشن کمٹس پر باطل کاری، اور `hippo recall --why` کے ذریعے قابل وضاحت یادداشت کا احاطہ کرتی ہیں۔ پرائیویسی نوٹس یادداشت بطور ڈیفالٹ کوئی نیٹ ورک کال نہیں کرتی۔ README انکشاف کرتا ہے کہ `hippo sleep` میموری متن کو Anthropic کو حقیقت نکالنے کے لیے بھیجتا ہے جب `ANTHROPIC_API_KEY` سیٹ ہو، اور یہ کہ اسے `.hippo/config.json` میں غیر فعال کیا جا سکتا ہے۔ ہوسٹڈ TypeSafe Jev ریرینکر اختیاری ہے اور بطور ڈیفالٹ بند ہے۔ ثبوت اور احتیاطیں README ہر دعوے کو بینچ مارک یا ٹیسٹ سے جوڑتا ہے، بشمول ترتیب وار سیکھنے کا بینچ مارک، LongMemEval اوریکل اسپلٹ نتیجہ (R@5 = 74.0% صرف BM25 کے ساتھ)، نجی 300-سوال ریرینکر تشخیص، اور مرحلہ وار Slack کارپس۔ یہ یہ بھی کہتا ہے کہ ایک پہلے کا شدت کا دعوا واپس لے لیا گیا تھا، اور یہ کہ سپرسیڈ میکانزم کو ماپا نہیں گیا ہے۔ پروجیکٹ بغیر کسی ماڈیول موک کے حقیقی ڈیٹا بیس کے خلاف 3,500+ ٹیسٹوں کی اطلاع دیتا ہے۔