kotobase
مینو

ڈویلپرز

تکنیکی تفصیلات، قانونی دستاویزات اور کھاتے کے بعض عمل اب بھی انگریزی میں ہیں۔

اپنے اپلیکیشن کی زبان اور گراف پروٹوکول سے شروع کریں جو آپ پہلے ہی استعمال کر رہے ہیں۔

ایک ٹوکن حاصل کریں

کوئی کارڈ درکار نہیں

Passkey یا EIP-4361 SIWE والیٹ کے ساتھ سیشن بنائیں۔ پھر Kotobase ایک مختصر مدت کا Biscuit جاری کرتا ہے جو ایک کرایہ دار، گراف، ہولڈر، میعاد ختم ہونے، اور اجازت سیٹ تک محدود ہوتا ہے۔

KOTOBASE_TOKEN کیا ہے

پرائمری API اسناد ایک مختصر مدت کا Biscuit ہے جو صرف Passkey یا SIWE تصدیق کے بعد جاری ہوتا ہے۔ اسے بالکل اسی گراف اور اجازتوں کے لیے درخواست کریں جو آپ کو چاہیے:

POST https://auth.kotobase.net/v1/biscuit/token

{"tenantId":"...","graph":"...","permissions":["data:write"]}

اینڈ پوائنٹ سے واپس آنے والی مکمل اجازت کی قدر استعمال کریں:

Authorization: Biscuit <token>

CACAO اور opaque Bearer اسناد صرف مائیگریشن کے لیے مطابقت کے راستے رہتی ہیں۔

اسے استعمال کریں

واپس آنے والی اجازت کی قدر کو براہ راست TypeScript، Python، یا PHP SDK کو دیں:

export KOTOBASE_TOKEN="Biscuit ..." && kotobase account-status

رد شدہ Biscuit کو کبھی CACAO یا Bearer کے طور پر دوبارہ کوشش نہیں کیا جاتا۔

راستے بنائیں

کمانڈ لائن

CLI کو ایک کمانڈ میں انسٹال کریں:

curl -fsSL https://kotobase.net/install.sh | sh

اسے چاہیے babashka اور صرف آپ کے اپنے کو لکھتا ہے ~/.local.

SDKs

TypeScript، Python، اور PHP کلائنٹس ایک ہی ٹرانسپورٹ اور تصدیقی معاہدہ شیئر کرتے ہیں۔

استفساری پروٹوکولز

Datomic کلائنٹ API، SPARQL (بشمول RDF4J HTTP path مطابقت)، Cypher، Gremlin، اور GraphQL کو واضح صلاحیت کی دریافت اور تعمیل کے ٹیسٹ کے ذریعے ٹریک کیا جاتا ہے۔

AI اور ایجنٹس

MCP اینڈپوائنٹ استعمال کریں

https://kotobase.net/mcp

اسی ٹیننٹ گراف کے خلاف، یا چلائیں

kotobase mcp

کلائنٹ کنفیگریشن جاری کرنے کے لیے۔

لوکل-فرسٹ نالج

Obsidian والٹ کو درآمد کریں یا دو طرفہ ہم آہنگی کریں جبکہ Markdown، frontmatter، اور [[wikilinks]] کو محفوظ رکھیں۔

کوئری پلین آرکیٹیکچر

Ayatori

Ayatori وہ کوئری-پلین کمپوزیشن ہے جو پرووائیڈر دریافت اور ناقابلِ تبدیلی IPLD بلاکس کو ایک مستقل، قابلِ سوال پروجیکشن میں تبدیل کرتا ہے۔

Ayatori کا ماخذ اور API پڑھیں

متصل پڑھنے کا راستہ

IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog

دریافت صرف ایک پرووائیڈر اشارہ ہے۔ Ayatori اسے بازیافت، CID کی درستگی، یا کوئری کے نفاذ کے ثبوت کے طور پر نہیں لیتا۔

موجودہ تعیناتی کی حیثیت

30 اگست 2026 تک، مشترکہ kotobase.net پروڈکشن کوئری درخواست راستہ ayatori.query پر مشتمل ہے، اور پروڈکشن کمپونینٹ لاک کے نام ayatori ہیں۔

یہ تبدیلی اس بات کی ہے کہ کون سا ریپوزیٹری پروڈکشن فراہم کرتا ہے، نہ کہ یہ کہ وہ کیا حساب لگاتا ہے: ayatori.query ایک عرفی نام ہے جو اسی پل پر ہے۔ IPNI پرووائیڈر دریافت اور تصدیق شدہ ریموٹ بلاک پڑھائیاں اب بھی درخواست کے راستے پر انجام نہیں دی جاتیں۔

لائبریری کی حدود اور انحصارات

لائبریری ذمہ داری براہ راست تعلق حیثیت
ayatori دریافت، تصدیق شدہ ریموٹ پڑھائیاں، مستقل کرسرز، اور کوئری میٹریلائزیشن کو مربوط کرتا ہے۔ io-ipni-specs، io-ipld، arrangement، اور kotobase استعمال کرتا ہے۔ پروڈکشن درخواست راستے پر؛ اس کی دریافت اور ریموٹ-ریڈ پلین شامل نہیں ہیں
io-ipni-specs IPNI اشتہارات اور ڈیلیگیٹڈ-روٹنگ پرووائیڈر نتائج کو پارس کرتا ہے۔ پرووائیڈر امیدوار واپس کرتا ہے؛ یہ بلاکس کو حاصل یا تصدیق نہیں کرتا۔ Ayatori انحصار
io-ipld IPLD لنکس کو انکوڈ اور ڈیکوڈ کرتا ہے اور بلاکس کو درخواست کردہ CIDs کے خلاف تصدیق کرتا ہے۔ Ayatori اور مستقل انڈیکس اسٹیک کے ذریعہ استعمال ہوتا ہے۔ پروڈکشن کمپونینٹ انحصار
arrangement چار کورنگ انڈیکسز کو CID-ایڈریسڈ اسنیپ شاٹس کے طور پر مستقل بناتا ہے اور کرسر پڑھائیاں فراہم کرتا ہے۔ prolly-tree، datom-source، اور datalog استعمال کرتا ہے۔ پروڈکشن کمپونینٹ انحصار
prolly-tree آرڈرڈ انڈیکس نوڈز کو مواد-ایڈریسڈ DAG-CBOR بلاکس کے طور پر ذخیرہ کرتا ہے۔ arrangement کو lookup، prefix scan، اور range scan فراہم کرتا ہے۔ پروڈکشن کمپونینٹ انحصار
datom-source کوئری راستوں میں استعمال ہونے والے اسٹوریج-نیوٹرل پیٹرن کرسر معاہدے کی تعریف کرتا ہے۔ کوئری کے جائزے کو کسی مخصوص اسٹوریج نفاذ سے الگ کرتا ہے۔ پروڈکشن کمپونینٹ انحصار
ڈیٹا لاگ چار کورنگ انڈیکسز پر Datalog کا جائزہ لیتا ہے؛ اس کے پاس کوئی اسٹوریج یا نیٹ ورک I/O نہیں ہے۔ کالر کی طرف سے فراہم کردہ ڈیٹم ذرائع اور انڈیکسز استعمال کرتا ہے۔ پروڈکشن کمپونینٹ انحصار
kotobase-query فلیٹ Kotobase اسٹور سے Datalog میٹریلائزیشن کے لیے مطابقت کا پل۔ اس کے دو نامی اسپیس ayatori کے ذریعے چلائے جاتے ہیں، لہٰذا جو کالرز انہیں اب بھی نام دیتے ہیں وہ حل ہوتے رہتے ہیں۔ متروک؛ اب وہی نامی اسپیس ayatori سے فراہم کیے جاتے ہیں

حالت کے لیبلز 30 اگست 2026 کو معائنہ کیے گئے مشترکہ پروڈکشن کوئری اجزاء کی وضاحت کرتے ہیں۔ ایک سورس پن یا کامیاب بینچ مارک بذات خود یہ ثابت نہیں کرتا کہ کوئی لائبریری پروڈکشن درخواستوں کی خدمت کرتی ہے۔

تعمیر شروع کریں