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

Hindsight একটি ওপেন-সোর্স এজেন্ট মেমরি সিস্টেম যা AI এজেন্টদের সময়ের সাথে শিখতে এবং উন্নত করতে সাহায্য করার জন্য ডিজাইন করা হয়েছে, সাধারণ কথোপকথন স্মরণের বাইরে গিয়ে। এটি দীর্ঘমেয়াদী মেমরি কাজের জন্য RAG এবং নলেজ গ্রাফ পদ্ধতির বিকল্প হিসেবে নিজেকে অবস্থান করে। ## এটি কী করে Hindsight মানব মেমরি কীভাবে কাজ করে তা থেকে অনুপ্রাণিত বায়োমিমেটিক ডেটা স্ট্রাকচার ব্যবহার করে স্মৃতি সংগঠিত করে। স্মৃতিগুলি শ্রেণীবদ্ধ করা হয়: - **বিশ্ব তথ্য**: বিশ্ব সম্পর্কে সাধারণ তথ্য - **অভিজ্ঞতা**: এজেন্টের নিজস্ব সরাসরি অভিজ্ঞতা - **পর্যবেক্ষণ**: সময়ের সাথে অনেক স্মৃতি থেকে গঠিত একীভূত, প্রমাণ-ভিত্তিক বিশ্বাস - **মানসিক মডেল**: এজেন্টের বিশ্বের শেখা বোঝাপড়া, পর্যবেক্ষণ এবং তথ্য থেকে সংশ্লেষিত সিস্টেমটি তিনটি মূল অপারেশন প্রদান করে: 1. **Retain** — নতুন তথ্য সংরক্ষণ করে। সত্তা, সম্পর্ক এবং অস্থায়ী ডেটা বের করতে একটি LLM ব্যবহার করে, তারপর সেগুলিকে পরবর্তী পুনরুদ্ধারের জন্য ক্যানোনিকাল উপস্থাপনায় স্বাভাবিক করে। 2. **Recall** — চারটি সমান্তরাল কৌশল ব্যবহার করে স্মৃতি পুনরুদ্ধার করে: শব্দার্থিক ভেক্টর সাদৃশ্য, কীওয়ার্ড BM25 ম্যাচিং, গ্রাফ-ভিত্তিক সত্তা/অস্থায়ী/কারণগত লিংক এবং অস্থায়ী সময়-পরিসীমা ফিল্টারিং। ফলাফলগুলি পারস্পরিক র্যাঙ্ক ফিউশনের মাধ্যমে একীভূত এবং পুনরায় র্যাঙ্ক করা হয়। 3. **Reflect** — নতুন সংযোগ গঠন, জটিল প্রশ্নের উত্তর বা পুঙ্খানুপুঙ্খ বোঝাপড়া তৈরি করতে বিদ্যমান স্মৃতিগুলির গভীর বিশ্লেষণ করে। পর্যবেক্ষণগুলি স্বয়ংক্রিয়ভাবে পটভূমিতে সম্পর্কিত ধরে রাখা তথ্য থেকে একীভূত হয়, সঠিক উদ্ধৃতি সহ সমর্থনকারী প্রমাণ রাখে। মানসিক মডেলগুলি সংজ্ঞায়িত প্রশ্নের স্থায়ী উত্তর যা Hindsight ব্যাংক আরও শেখার সাথে সাথে পুনরায় লেখে। ## এটি কীভাবে ব্যবহার করবেন ### ডিপ্লয়মেন্ট বিকল্প - **Docker** (প্রস্তাবিত): `docker run` দিয়ে একটি একক কন্টেইনার চালান, পোর্ট 8888-এ API এবং পোর্ট 9999-এ UI প্রকাশ করে। - **Bare metal**: `pip install hindsight-api` দিয়ে ইনস্টল করুন এবং সরাসরি চালান। - **Kubernetes**: `oci://ghcr.io/vectorize-io/charts/hindsight` থেকে Helm চার্ট উপলব্ধ। - **Embedded (Python)**: `pip install hindsight-all` একটি ইন-প্রসেস সার্ভারের জন্য, আলাদা ডিপ্লয়মেন্টের প্রয়োজন নেই। - **Hindsight Cloud**: স্বয়ংক্রিয় স্কেলিং এবং 99.9% আপটাইম SLA সহ পরিচালিত হোস্টেড বিকল্প। সার্ভারটি OpenAI, Anthropic, Gemini, Groq, Bedrock, Ollama এবং যেকোনো OpenAI-সামঞ্জস্যপূর্ণ এন্ডপয়েন্ট সহ 25+ LLM প্রদানকারীর সাথে কাজ করে। ChatGPT Plus, Claude Pro, Cursor এবং GitHub Copilot-এর জন্য বিদ্যমান সাবস্ক্রিপশন API কী ছাড়াই কাজ করে। ### ক্লায়েন্ট লাইব্রেরি Python (`hindsight-client`), Node.js/TypeScript (`@vectorize-io/hindsight-client`), Go এবং একটি CLI সবই উপলব্ধ। একটি সহজ উদাহরণ: ```python from hindsight_client import Hindsight client = Hindsight(base_url="http://localhost:8888") client.retain(bank_id="my-bank", content="Alice works at Google") results = client.recall(bank_id="my-bank", query="What does Alice do?") ``` ### দ্রুত ইন্টিগ্রেশন LiteLLM র্যাপার (`hindsight-litellm`) আপনাকে দুই লাইনের কোডে একটি বিদ্যমান LLM ক্লায়েন্ট মোড়ানোর অনুমতি দেয়, প্রতিটি কলের আগে স্বয়ংক্রিয়ভাবে প্রাসঙ্গিক স্মৃতি স্মরণ করে এবং পরে কথোপকথন ধরে রাখে। এটি LiteLLM-এর মাধ্যমে 100+ মডেল কভার করে। ### ইন্টিগ্রেশন Hindsight-এ 60+ ইন্টিগ্রেশন রয়েছে যার জন্য কোড পরিবর্তনের প্রয়োজন নেই, যার মধ্যে রয়েছে: - **কোডিং এজেন্ট**: Claude Code, Codex, Cursor, GitHub Copilot, Aider, Cline এবং অন্যান্য — git ইতিহাস থেকে নির্মিত প্রতি-রেপো প্রকল্প মেমরির জন্য একটি ডেডিকেটেড প্যাকেজ সহ। - **এজেন্ট ফ্রেমওয়ার্ক**: LangGraph/LangChain, LlamaIndex, CrewAI, Pydantic AI, OpenAI Agents SDK, Google ADK, AutoGen এবং আরও অনেক কিছু। - **নো-কোড/লো-কোড**: n8n, Zapier, Dify, Flowise। - **অ্যাপ**: ChatGPT, Perplexity, Obsidian, Vapi, Pipecat। প্রতিটি সার্ভার `/mcp/{bank_id}/`-এ একটি অন্তর্নির্মিত MCP এন্ডপয়েন্টও প্রকাশ করে, যা যেকোনো MCP ক্লায়েন্টকে retain, recall এবং reflect টুল হিসেবে ব্যবহার করতে সক্ষম করে। ## মূল বৈশিষ্ট্য - **ডিফল্টভাবে বহুভাষিক**: ইনপুট ভাষা সনাক্ত এবং সংরক্ষিত হয়; সত্তাগুলি তাদের স্থানীয় লিপি রাখে (যেমন, 张伟 张伟 হিসাবে থাকে)। - **মেমরি ডিফেন্স**: একটি অপ্ট-ইন প্রতি-ব্যাংক নীতি যা 45টি প্যাটার্নের বিরুদ্ধে প্রতিটি retain-এ গোপনীয়তা এবং PII স্ক্যান করে, সংরক্ষণের আগে মিলগুলি রিড্যাক্ট বা ব্লক করে। - **মেমরি ব্যাংক**: প্রতি ব্যবহারকারী, এজেন্ট বা প্রকল্পের জন্য বিচ্ছিন্ন মেমরি স্টোর, ব্যাংকগুলির মধ্যে কঠোর নো-লিকেজ সহ। ব্যাংকগুলি সন্দেহবাদিতা, আক্ষরিকতা, সহানুভূতির মতো স্বভাব বৈশিষ্ট্য বহন করতে পারে যা reflect-এর যুক্তি গঠন করে। - **প্রোডাকশন প্রস্তুতি**: স্টোরেজের জন্য pgvector বা Oracle AI Database সহ PostgreSQL, Prometheus মনিটরিং, অপারেশনের জন্য অ্যাডমিন CLI, লাইফসাইকেল ইভেন্টের জন্য ওয়েবহুক এবং টেন্যান্ট/অথ/স্টোরেজ এক্সটেনশন পয়েন্ট। - **নলেজ পেজ**: একটি ব্যাংক নিজের সম্পর্কে লেখা জীবন্ত ডকুমেন্ট, একটি উইকির মতো সংগঠিত এবং মার্কডাউন ফাইল হিসাবে প্রজেক্টযোগ্য। ## পারফরম্যান্স দাবি README অনুসারে, Hindsight জানুয়ারি 2026 পর্যন্ত LongMemEval বেঞ্চমার্কে স্টেট-অফ-দ্য-আর্ট পারফরম্যান্স অর্জন করেছে। বেঞ্চমার্ক ডেটা স্বাধীনভাবে ভার্জিনিয়া টেকের Sanghani সেন্টার এবং The Washington Post-এর গবেষকরা পুনরুত্পাদন করেছেন; অন্যান্য স্কোর বিক্রেতাদের দ্বারা স্ব-প্রতিবেদিত। লাইভ ফলাফল benchmarks.hindsight.vectorize.io-এ প্রকাশিত হয়।