প্রকল্প সম্পর্কে

Hippo হলো AI কোডিং এজেন্টদের জন্য একটি মেমরি লেয়ার, যা npm প্যাকেজ `hippo-memory` হিসেবে বিতরণ করা হয়। এর ঘোষিত ভিত্তি হলো—ভালো মেমরি মানে কী ভুলতে হবে তা জানা: যে মেমরিগুলো ভুল প্রমাণিত হয়েছে, প্রতিস্থাপিত হয়েছে, বা কখনো ব্যবহার হয়নি, সেগুলোর র‍্যাঙ্কিং কমা উচিত বা রিকল থেকে সম্পূর্ণ বাদ পড়া উচিত। এটি MIT-লাইসেন্সপ্রাপ্ত এবং Node.js 22.16+ প্রয়োজন। স্টোরেজ ও রিট্রিভাল মেমরিগুলো `.hippo/hippo.db`-তে একটি লোকাল SQLite ডেটাবেসে থাকে, প্রতিটি পরিবর্তনের পরে markdown মিরর লেখা হয় যাতে স্টোরটি মানুষের পাঠযোগ্য ও git-ট্র্যাকযোগ্য হয়। সার্চ ডিফল্টভাবে BM25, কোনো মডেল বা নেটওয়ার্ক কল ছাড়াই; এমবেডিং হলো ঐচ্ছিক ইনস্টল (লোকাল Transformers.js, অথবা OpenAI, Voyage বা Cohere থেকে অপ্ট-ইন API এমবেডার)। প্রকল্পটি শূন্য রানটাইম ডিপেন্ডেন্সি রিপোর্ট করে। একটি MCP সার্ভার ও একটি HTTP API যেকোনো সামঞ্জস্যপূর্ণ ক্লায়েন্টের কাছে স্টোরটি উন্মুক্ত করে। ফলাফল থেকে শেখা দুটি প্রক্রিয়া পরিমাপযোগ্য হিসেবে বর্ণিত: কোনো রিকল করা মেমরিকে ভুল বলে চিহ্নিত করলে তার র‍্যাঙ্কিং কমে, এবং বারবার ব্যবহার কোনো মেমরিকে শক্তিশালী করে। `hippo supersede` একটি প্রতিস্থাপিত তথ্যকে রিকল থেকে সরিয়ে দেয়। error-ট্যাগযুক্ত মেমরিগুলো সাধারণ মেমরির দ্বিগুণ half-life পায়। ডিফল্ট half-life ৩৬৫ দিন; README-তে একটি pre-registered মূল্যায়নের কথা বলা হয়েছে যেখানে ৭ দিন একটি তথ্যের বর্তমান সংস্করণ অনেক বেশি বার হারিয়েছে, অন্যদিকে ৭৩০ দিন ও decay-বন্ধ ৩৬৫ দিনের সাথে সমান ছিল। Decay, তিন-স্তরের স্টোরেজ ও sleep consolidation হিপোক্যাম্পাস দ্বারা অনুপ্রাণিত হিসেবে বর্ণিত, এবং README-তে বলা হয়েছে যে তাদের পরীক্ষায় decay, decay নিষ্ক্রিয় থাকার সাথে সমান ছিল এবং sleep রিকল কমিয়েছে। সেটআপ ও ইন্টিগ্রেশন একটি প্রকল্পের ভিতরে `hippo init` চালালে `.hippo/` স্টোর তৈরি হয়, বিদ্যমান `CLAUDE.md` বা `AGENTS.md`-এ একটি চিহ্নিত ব্লক যোগ হয়, শনাক্ত করা এজেন্টদের জন্য হুক ইনস্টল হয় (Claude Code সেটিংস, একটি OpenCode প্লাগইন, Codex `hooks.json` এন্ট্রি যেগুলোর জন্য এককালীন trust প্রয়োজন), এবং প্রতিদিন সকাল ৬:১৫-তে একটি রান শিডিউল হয়। `hippo init --scan <folder>` তিন স্তর গভীর পর্যন্ত git রেপো খুঁজে বের করে এবং প্রতিটিকে গত ৩৬৫ দিনের কমিট থেকে সিড করে। `--no-hooks`, `--no-schedule` ও `--no-learn` ফ্ল্যাগগুলো আলাদা আলাদা অংশ বাদ দেয়। `hippo doctor` সেটআপ যাচাই করে। ফিচার ইমপোর্টারগুলো ChatGPT এক্সপোর্ট, CLAUDE.md, Cursor রুলস, markdown ও প্লেইন টেক্সট কভার করে, dry-run ও ডুপ্লিকেট শনাক্তকরণসহ। Conversation capture LLM-এর বদলে প্যাটার্ন হিউরিস্টিক দিয়ে সিদ্ধান্ত, নিয়ম, ত্রুটি ও পছন্দ নিষ্কাশন করে। Slack ও GitHub webhook কানেক্টর ইভেন্টগুলোকে provenance ও deletion handling সহ কাঁচা মেমরি হিসেবে গ্রহণ করে। অতিরিক্ত কমান্ডগুলো কভার করে active task snapshot, session event trail, handoff, একটি সীমাবদ্ধ working-memory scratchpad, confidence tier (verified, observed, inferred, stale), conflict tracking, migration কমিটে invalidation, এবং `hippo recall --why`-এর মাধ্যমে ব্যাখ্যাযোগ্য রিকল। গোপনীয়তা নোট রিকল ডিফল্টভাবে কোনো নেটওয়ার্ক কল করে না। README প্রকাশ করে যে `ANTHROPIC_API_KEY` সেট থাকলে `hippo sleep` fact extraction-এর জন্য Anthropic-এ মেমরি টেক্সট পাঠায়, এবং এটি `.hippo/config.json`-এ নিষ্ক্রিয় করা যায়। হোস্টেড TypeSafe Jev reranker অপ্ট-ইন এবং ডিফল্টভাবে বন্ধ। প্রমাণ ও সতর্কতা README প্রতিটি দাবিকে একটি বেঞ্চমার্ক বা টেস্টের সাথে লিঙ্ক করে, যার মধ্যে আছে একটি sequential-learning বেঞ্চমার্ক, একটি LongMemEval oracle split ফলাফল (শুধু BM25 দিয়ে R@5 = 74.0%), একটি ব্যক্তিগত ৩০০-কোয়েরি reranker মূল্যায়ন, এবং একটি staged Slack কর্পাস। এটি আরও বলে যে একটি পূর্ববর্তী magnitude দাবি প্রত্যাহার করা হয়েছিল, এবং supersede প্রক্রিয়াটি পরিমাপ করা হয়নি। প্রকল্পটি একটি বাস্তব ডেটাবেসের বিরুদ্ধে ৩,৫০০+ টেস্ট রিপোর্ট করে, কোনো module mock ছাড়াই।