kotobase
Menu

Pengembang

Detail teknis, dokumen hukum, dan sebagian proses akun masih dalam bahasa Inggris.

Mulai dengan bahasa dan protokol grafik yang sudah digunakan aplikasi Anda.

Dapatkan token

Tidak perlu kartu

Buat sesi dengan Passkey atau dompet EIP-4361 SIWE. Kotobase kemudian mengeluarkan Biscuit berumur pendek yang dibatasi untuk satu penyewa, grafik, pemegang, masa berlaku, dan set izin.

Apa itu KOTOBASE_TOKEN

Kredensial API utama adalah Biscuit berumur pendek yang hanya diterbitkan setelah autentikasi Passkey atau SIWE. Minta untuk grafik dan izin yang tepat Anda butuhkan:

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

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

Gunakan nilai otorisasi lengkap yang dikembalikan oleh endpoint:

Authorization: Biscuit <token>

Kredensial CACAO dan Bearer opak tetap sebagai jalur kompatibilitas hanya migrasi.

Gunakan itu

Loloskan nilai otorisasi yang dikembalikan langsung ke SDK TypeScript, Python, atau PHP:

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

Biscuit yang ditolak tidak pernah dicoba ulang sebagai CACAO atau Bearer.

Bangun jalur

Baris perintah

Pasang CLI dalam satu perintah:

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

Dibutuhkan babashka dan hanya menulis ke ~/.local.

SDK

Klien TypeScript, Python, dan PHP berbagi satu kontrak transport dan autentikasi.

Protokol query

Datomic Client API, SPARQL (termasuk kompatibilitas jalur HTTP RDF4J), Cypher, Gremlin, dan GraphQL dilacak melalui penemuan kapabilitas eksplisit dan tes konformansi.

AI dan agen

Gunakan endpoint MCP di

https://kotobase.net/mcp

melawan grafik tenant yang sama, atau jalankan

kotobase mcp

untuk mengeluarkan konfigurasi klien.

Pengetahuan lokal-pertama

Impor atau sinkronisasi dua arah vault Obsidian sambil mempertahankan Markdown, frontmatter, dan [[wikilinks]].

Arsitektur bidang kueri

Ayatori

Ayatori adalah komposisi bidang kueri yang mengubah penemuan penyedia dan blok IPLD yang tidak dapat diubah menjadi proyeksi yang persisten dan dapat dikueri.

Baca sumber dan API Ayatori

Jalur baca yang terhubung

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

Penemuan hanyalah petunjuk penyedia. Ayatori tidak menganggapnya sebagai bukti pengambilan, validitas CID, atau eksekusi kueri.

Status penyebaran saat ini

Per 30 Agustus 2026, jalur permintaan kueri produksi kotobase.net bersama disusun pada ayatori.query, dan nama kunci komponen produksi adalah ayatori.

Itu adalah perubahan repositori mana yang melayani produksi, bukan apa yang dihitung: ayatori.query adalah namespace alias di atas jembatan yang sama. Penemuan penyedia IPNI dan pembacaan blok jarak jauh yang diverifikasi masih belum dilakukan pada jalur permintaan.

Batas dan ketergantungan perpustakaan

Perpustakaan Tanggung jawab Hubungan langsung Status
ayatori Mengkoordinasikan penemuan, pembacaan jarak jauh yang diverifikasi, kursor persisten, dan materialisasi kueri. Menggunakan io-ipni-specs, io-ipld, arrangement, dan kotobase. Pada jalur permintaan produksi; bidang penemuan dan pembacaan jarak jauhnya tidak
io-ipni-specs Mengurai iklan IPNI dan hasil penyedia routing-delegasi. Mengembalikan kandidat penyedia; tidak mengambil atau memverifikasi blok. Ketergantungan Ayatori
io-ipld Mengkodekan dan mendekode tautan IPLD serta memverifikasi blok terhadap CID yang diminta. Digunakan oleh Ayatori dan tumpukan indeks persisten. Ketergantungan komponen produksi
arrangement Menyimpan empat indeks penutup sebagai snapshot beralamat CID dan mengekspos pembacaan kursor. Menggunakan prolly-tree, datom-source, dan datalog. Ketergantungan komponen produksi
prolly-tree Menyimpan node indeks terurut sebagai blok DAG-CBOR beralamat konten. Menyediakan pencarian, pemindaian awalan, dan pemindaian rentang ke arrangement. Ketergantungan komponen produksi
datom-source Mendefinisikan kontrak kursor pola netral penyimpanan yang digunakan oleh jalur kueri. Memisahkan evaluasi kueri dari implementasi penyimpanan tertentu. Ketergantungan komponen produksi
datalog Mengevaluasi Datalog melalui empat indeks penutup; tidak memiliki penyimpanan atau I/O jaringan. Mengonsumsi sumber datom dan indeks yang disediakan oleh pemanggil. Ketergantungan komponen produksi
kotobase-query Jembatan kompatibilitas dari penyimpanan Kotobase datar ke materialisasi Datalog. Dua namespace-nya dibawa oleh ayatori, sehingga pemanggil yang masih menamai mereka tetap dapat menyelesaikan. Digantikan; namespace yang sama sekarang dikirim dari ayatori

Label status menggambarkan komponen kueri produksi bersama yang diperiksa pada 30 Agustus 2026. Pin sumber atau tolok ukur yang lolos tidak membuktikan sendiri bahwa sebuah pustaka melayani permintaan produksi.

Mulai membangun