Neotoma AI ایجنٹوں کے لیے ایک ساختی میموری کی تہہ ہے۔ یہ ذاتی ڈیٹا کے ساتھ اسی طرح برتاؤ کرتا ہے جس طرح پروڈکشن سسٹم ریاست کے ساتھ سلوک کرتے ہیں: ٹائپ شدہ ہستی، مستحکم IDs، مکمل پرویننس، تعییناتی سوالات۔ یہ ڈویلپر ریلیز اب دستیاب ہے۔ npm کے ذریعے انسٹال کریں، اپنے AI ٹولز کو MCP کے ذریعے جوڑیں، اور اسے اپنی مشین پر چلائیں۔

دستاویزات اور سیٹ اپ: [neotoma.io](https://neotoma.io)۔ Repo: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma)۔

## مسئلہ

میں نے گزشتہ سال AI ایجنٹس کے ذریعے ورک فلو چلانے میں گزارا ہے: ای میل، کام، مالیات، رابطے، مواد۔ ایجنٹ قابل ہیں۔ مسئلہ اعتماد کا ہے۔

یادداشت واضح طور پر تبدیل ہوتی ہے۔ سیاق و سباق بڑھتا ہے۔ ایجنٹ نئے سیشن میں ایک ہی سوال کا مختلف جواب دیتا ہے۔ یہ کسی رابطے کو اوور رائٹ کر دیتا ہے اور پچھلی حالت ختم ہو جاتی ہے۔ میں غلط نمبر کو اس کے ماخذ پر واپس نہیں ٹریس کر سکتا ہوں۔ میں ایک مختلف ٹول سے ایک جیسے ریکارڈز استعمال نہیں کر سکتا۔

یہ ایج کیسز نہیں ہیں۔ جیسے ہی ایجنٹ جاری حالت کو سنبھالتے ہیں وہ ظاہر ہوتے ہیں: کام، لین دین، وعدے، تعلقات۔ میں جتنا زیادہ نمائندگی کرتا ہوں، حدیں اتنی ہی تیز ہوتی جاتی ہیں۔

جو چیز ٹوٹتی رہتی ہے وہ عقل نہیں ہوتی۔ یہ اعتماد ہے۔ میں نے سب سے پہلے اس کے بارے میں [Building a Truth layer for Persistent agent memory](/posts/truth-layer-agent-memory) میں لکھا تھا۔

## جہاں کرنٹ میموری کم ہو جاتی ہے۔

آج زیادہ تر ایجنٹ میموری بازیافت ہے: RAG، ایجنٹ کی تلاش، سرایت کرنے والی مماثلت، فراہم کنندہ کے زیر کنٹرول میموری۔ بازیافت کا کام ایکسپلوریشن اور یک طرفہ سوالات کے لیے ہوتا ہے۔ یہ جاری ریاست کے لیے الگ ہو جاتا ہے۔

[RAG بے کار نتائج سے بھرتا ہے](/posts/why-agent-memory-needs-more-than-rag) جب ایجنٹ میموری ایک پابند، مربوط سلسلہ ہو۔ Top-k آپ کی ضرورت کے بجائے تکرار لوٹاتا ہے۔ کٹائی کے ٹکڑے ثبوت زنجیروں. مماثلت ساخت کو نظر انداز کرتی ہے۔

فراہم کنندہ میموری (ChatGPT Memory، Claude Projects) صرف بات چیت اور پلیٹ فارم سے منسلک ہے۔ یہ مبہم ہے، اس کا کوئی پرویننس یا رول بیک نہیں ہے، اور تمام ٹولز پر کام نہیں کرتا ہے۔ آپ اس سے قطعی طور پر استفسار نہیں کر سکتے یا اس کے ماخذ سے کسی حقیقت کا پتہ نہیں لگا سکتے۔

[ایجنٹک تلاش](/posts/agentic-search-and-the-truth-layer) ہر سیشن کا دوبارہ اندازہ لگاتا ہے۔ کوئی مستقل کیننیکل شناخت نہیں، کوئی ضمانت نہیں کہ ایک ہی سوال ایک ہی نتیجہ برآمد کرتا ہے۔ یہ کوڈنگ اور ایکسپلوریشن کے لیے کام کرتا ہے۔ کاموں، رابطوں، لین دین اور واقعات کے لیے، آپ کو اگلے ہفتے ایک ہی جواب، مکمل سیٹس، اور آڈٹ ٹریلز کی ضرورت ہے۔ بازیافت اس کی فراہمی نہیں کرتی ہے۔

[مفید تقسیم](/posts/agent-memory-truth-problem) بازیافت بمقابلہ ساختی حالت ہے، گراف بمقابلہ مارک ڈاؤن نہیں۔ بازیافت مطابقت اور دریافت کے لیے بہتر بناتا ہے۔ سٹرکچرڈ سٹیٹ مستقل مزاجی، مکمل ہونے اور پیدا کرنے کے لیے بہتر بناتی ہے۔ بڑے منصوبے (Zep, Mem0, Letta, LangMem) ڈھانچے میں اضافہ کر رہے ہیں، لیکن مکمل ہم آہنگی کو تعمیراتی رکاوٹوں کا سامنا ہے۔ جب ایجنٹ آپ کی طرف سے کام کرتے ہیں، تو آپ کو بعد کی ضرورت ہوتی ہے۔

میں نے ان [چھ ساختی رجحانات](/posts/six-agentic-trends-betting-on) کے بارے میں الگ سے لکھا ہے جو وقت کے ساتھ ساتھ اس فرق کو وسیع تر بناتے ہیں: ایجنٹوں کا ریاستی ہونا، غلطیاں قیمتیں بننا، پلیٹ فارم کا مبہم رہنا، ٹولز بکھرے رہنا۔

## Neotoma کیا ہے؟

نیوٹوما ایک سچائی پرت ہے: میموری سبسٹریٹ جو آپ کے ایجنٹوں کے نیچے بیٹھتا ہے۔ ایجنٹ وہی کرتے رہتے ہیں جو وہ کرتے ہیں (براؤزنگ، رائٹنگ، کالنگ ٹولز)۔ Neotoma اس ریاست کا مالک ہے جو وہ پڑھتے لکھتے ہیں۔

آپ ایجنٹ کی بات چیت میں دستاویزات اپ لوڈ کرتے ہیں یا معلومات کا اشتراک کرتے ہیں۔ Neotoma تمام ذرائع میں اداروں کو حل کرتا ہے۔ لوگوں، کمپنیوں، کاموں، رسیدوں، واقعات کو مستحکم IDs ملتے ہیں۔ ہر حقیقت اپنی اصل کا پتہ دیتی ہے۔ ٹائم لائنز تاریخ کے شعبوں سے آتی ہیں۔ تصحیح تاریخ کو اوور رائٹ کرنے کے بجائے محفوظ کرتی ہے۔

گراف ایگزیکیوشن ایگنوسٹک ہے۔ یہ ماڈل کرتا ہے کہ کیا موجود ہے، نہ کہ کام کیسے ہوتا ہے۔ یہی ڈیٹا کرسر، ChatGPT، Claude، یا کسی MCP کلائنٹ سے دستیاب ہے۔ جب آپ [سوئچ ٹولز](/posts/openclaw-and-the-truth-layer) کرتے ہیں، تو یادداشت ختم نہیں ہوتی۔

یہ نوٹ لینے والی ایپ یا "دوسرا دماغ" نہیں ہے۔ فراہم کنندہ کے زیر کنٹرول میموری نہیں۔ ویکٹر اسٹور یا RAG پرت نہیں۔ خود مختار ایجنٹ نہیں۔ یہ اسکیما کی پہلی ساختی حالت ہے جسے آپ کنٹرول کرتے ہیں۔

## اس ریلیز میں کیا شامل ہے۔

یہ ڈویلپر ریلیز بنیادی معاہدے کو بے نقاب کرتا ہے:

- **CLI** انسانوں کے لیے۔
- **MCP** ایجنٹوں کے لیے (ChatGPT، Claude، Cursor، Claude Code)؛ ایجنٹ ایم سی پی کو بیک اپ کے طور پر استعمال کرتے ہیں۔
- **اوپن اے پی آئی** سچائی کے واحد ذریعہ کے طور پر۔

کنکریٹ کی فعالیت:

- **ڈبل پاتھ اسٹورنگ۔** فائلیں اپ لوڈ کریں یا ایجنٹ کی گفتگو سے سٹرکچرڈ ڈیٹا کو ایک گراف میں لکھیں۔
- **اینٹی ریزولیوشن۔** ہیش پر مبنی کینونیکل IDs تمام ذرائع میں ایک ہی ہستی کو متحد کرتی ہیں۔
- **سکیمہ رجسٹری۔** ٹائپ شدہ ہستی اور ٹائپ شدہ رشتے۔ اسکیماس ڈیٹا کی طرح تیار ہوتے ہیں۔
- **ٹائم لائنز۔** تمام اداروں میں ڈیٹ فیلڈز سے خودکار ٹائم لائن جنریشن۔
- **مکمل پیشرفت۔** ہر ریکارڈ اپنے ماخذ تک پہنچتا ہے۔ تصحیحیں نئے مشاہدات تخلیق کرتی ہیں، اوور رائٹ نہیں۔
- **سٹرکچرل بازیافت۔** ہستی کی قسم، ID، تعلق، یا وقت کی حد کے لحاظ سے استفسار۔ کراس ہستی کے استدلال کے لیے پڑوس کا گراف۔

کوئی ویب ایپ نہیں ہے۔ یہ انفراسٹرکچر ہے، کوئی پروڈکٹ نہیں۔ انٹرفیس CLI، MCP، اور API ہیں۔

## اصول اور کیوں مقامی - پہلے

تین بنیادیں ڈیزائن کی تشکیل کرتی ہیں:

**پرائیویسی سب سے پہلے۔** آپ کا ڈیٹا آپ کی مشین پر رہتا ہے۔ صرف مقامی اسٹوریج: SQLite اور مقامی فائلیں۔ کوئی کلاؤڈ انحصار نہیں ہے۔ تربیت کے لیے کبھی استعمال نہیں کیا گیا۔ آپ کنٹرول کرتے ہیں کہ کیا اندر جاتا ہے اور کیا رہتا ہے۔

**ڈیٹرمنسٹک۔** وہی ان پٹ، وہی آؤٹ پٹ۔ ہیش پر مبنی ہستی IDs۔ سکیما-پہلی نکالنا۔ اسٹوریج یا بازیافت کے لیے اہم راستے میں کوئی LLM نہیں ہے۔ ہر ریکارڈ پر مکمل ثبوت۔

**کراس پلیٹ فارم۔** ٹولز میں میموری کی ایک پرت۔ چیٹ جی پی ٹی، کلاڈ، کرسر، اور کلاڈ کوڈ MCP کے ذریعے جڑتے ہیں۔ کوئی فراہم کنندہ لاک ان نہیں ہے۔ ٹولز کو سوئچ کریں اور میموری ایک جیسی رہتی ہے۔

یہ ریلیز صرف ڈیزائن کے لحاظ سے مقامی ہے۔ اعتماد کنٹرول سے شروع ہوتا ہے۔ دور دراز کے بنیادی ڈھانچے کو شامل کرنے سے پہلے، معاہدہ اور ضمانتوں کا ٹھوس ہونا ضروری ہے۔ صرف مقامی کا مطلب ہے کہ آپ سسٹم کی ہر چیز کی تصدیق کر سکتے ہیں۔ یہ اس پرت کے لیے صحیح نقطہ آغاز ہے جو قابل اعتماد ہونے کا دعوی کرتی ہے۔

## یہ کس کے لیے ہے۔

ڈیولپرز اور ایجنٹ بنانے والے CLI-پہلے ورک فلو کے ساتھ آرام دہ ہیں۔ وہ لوگ جو ایجنٹی نظام بناتے یا چلاتے ہیں جنہیں سیشنز اور ٹولز میں مستقل میموری کی ضرورت ہوتی ہے۔ کوئی بھی جو ذاتی ڈیٹا کو پروڈکشن انفراسٹرکچر کی طرح برتاؤ کرتا ہے۔

(ابھی تک) کے لیے نہیں: UI-پہلے صارفین، آرام دہ نوٹ لینے، یا کوئی بھی جو آج استحکام کی ضمانت کی توقع کر رہا ہے۔ بریکنگ تبدیلیوں کی توقع کی جانی چاہئے۔ یہ ریلیز بنیادوں پر دباؤ کی جانچ کے لیے موجود ہے۔

## انسٹال اور کنیکٹ کریں۔

''بش
npm install -g neotoma # install
neotoma init # شروع کریں۔
neotoma # انٹرایکٹو سیشن شروع کریں۔
``

مکمل سیٹ اپ، API دستاویزات، MCP کنفیگریشن، اور اسکیما حوالہ: [neotoma.io](https://neotoma.io)۔

Repo: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma)۔

## ٹیک ویز

- **پرائیویسی سب سے پہلے۔** آپ کی مشین پر آپ کا ڈیٹا؛ صرف مقامی، کوئی بادل نہیں، تربیت کے لیے کبھی استعمال نہیں کیا گیا۔
- **CLI, MCP, OpenAPI.** انسانوں اور ایجنٹوں کے لیے ایک معاہدہ۔
- **سکیما-پہلی ساختی حالت۔** ٹائپ شدہ ہستی، مکمل پرویننس، تعییناتی سوالات۔

## اسے آزمائیں، اسے توڑ دیں، مجھے بتائیں

میں اسے سخت کرنے میں آپ کی مدد چاہتا ہوں۔ اسے چلائیں۔ ہٹ ایج کیسز۔ کیڑے، مبہم رویے، یا گمشدہ ٹکڑوں کی اطلاع دیں۔

تاثرات میں سب سے زیادہ اہمیت رکھتا ہوں: جہاں ضمانتیں ناکام ہوجاتی ہیں، جہاں معاہدہ راستے میں آتا ہے، جہاں ڈیزائن غلط تجارت کرتا ہے۔ GitHub پر مسائل کھولیں، پیچ جمع کروائیں، یا بحث شروع کریں۔

یہ ریلیز جان بوجھ کر سخت ہے۔ وشوسنییتا حقیقی استعمال اور حقیقی تاثرات سے آتی ہے، تنہائی میں چمکانے سے نہیں۔