Los detalles técnicos, los documentos legales y algunos procesos de cuenta siguen en inglés.
Comience con el lenguaje y el protocolo de grafo que su aplicación ya utiliza.
Cree una sesión con un Passkey o una billetera EIP-4361 SIWE. Kotobase luego emite un Biscuit de corta duración restringido a un solo inquilino, grafo, titular, expiración y conjunto de permisos.
La credencial principal de la API es un Biscuit de corta duración emitido solo después de la autenticación con Passkey o SIWE. Solicítelo para el grafo y permisos exactos que necesita:
POST https://auth.kotobase.net/v1/biscuit/token
{"tenantId":"...","graph":"...","permissions":["data:write"]}
Use el valor completo de autorización devuelto por el endpoint:
Authorization: Biscuit <token>
Las credenciales CACAO y Bearer opacas permanecen como rutas de compatibilidad solo para migración.
Pase el valor de autorización devuelto directamente al SDK de TypeScript, Python o PHP:
export KOTOBASE_TOKEN="Biscuit ..." && kotobase account-status
Un Biscuit rechazado nunca se reintenta como CACAO o Bearer.
Instale el CLI con un solo comando:
curl -fsSL https://kotobase.net/install.sh | sh
Necesita babashka y solo escribe en su propio ~/.local.
Los clientes de TypeScript, Python y PHP comparten un contrato de transporte y autenticación.
Datomic Client API, SPARQL (incluida la compatibilidad con ruta HTTP RDF4J), Cypher, Gremlin y GraphQL se rastrean mediante descubrimiento explícito de capacidades y pruebas de conformidad.
Use el endpoint MCP en
https://kotobase.net/mcp
contra el mismo grafo de inquilino, o ejecute
kotobase mcp
para emitir la configuración del cliente.
Importe o sincronice bidireccionalmente una bóveda Obsidian preservando Markdown, frontmatter y [[wikilinks]].
Ayatori es la composición del plano de consulta que convierte el descubrimiento de proveedores y bloques IPLD inmutables en una proyección persistente y consultable.
IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog
El descubrimiento es solo una pista del proveedor. Ayatori no lo trata como prueba de recuperación, validez de CID o ejecución de consulta.
A partir del 30 de agosto de 2026, la ruta de solicitud de consulta de producción compartida kotobase.net se compone en ayatori.query, y el nombre del bloqueo del componente de producción es ayatori.
Eso es un cambio de qué repositorio sirve producción, no de lo que calcula: ayatori.query es un espacio de nombres alias sobre el mismo puente. El descubrimiento de proveedores IPNI y las lecturas remotas verificadas de bloques aún no se realizan en la ruta de solicitud.
| Biblioteca | Responsabilidad | Relación directa | Estado |
|---|---|---|---|
| ayatori | Coordina el descubrimiento, lecturas remotas verificadas, cursores persistentes y materialización de consultas. | Usa io-ipni-specs, io-ipld, arrangement y kotobase. | En la ruta de solicitud de producción; sus planos de descubrimiento y lectura remota no lo están |
| io-ipni-specs | Analiza anuncios IPNI y resultados de proveedores de enrutamiento delegado. | Devuelve candidatos a proveedores; no recupera ni verifica bloques. | Dependencia de Ayatori |
| io-ipld | Codifica y decodifica enlaces IPLD y verifica bloques contra CIDs solicitados. | Usado por Ayatori y la pila de índice persistente. | Dependencia del componente de producción |
| arrangement | Persiste cuatro índices de cobertura como instantáneas direccionadas por CID y expone lecturas de cursores. | Usa prolly-tree, datom-source y datalog. | Dependencia del componente de producción |
| prolly-tree | Almacena nodos de índice ordenados como bloques DAG-CBOR direccionados por contenido. | Proporciona búsqueda, escaneo de prefijos y escaneo de rango a arrangement. | Dependencia del componente de producción |
| datom-source | Define el contrato de cursor de patrón neutral en almacenamiento usado por rutas de consulta. | Separa la evaluación de consultas de una implementación de almacenamiento particular. | Dependencia del componente de producción |
| datalog | Evalúa Datalog sobre cuatro índices de cobertura; no posee almacenamiento ni E/S de red. | Consume fuentes de datoms e índices suministrados por el llamador. | Dependencia del componente de producción |
| kotobase-query | Puente de compatibilidad desde la tienda plana Kotobase a la materialización Datalog. | Sus dos espacios de nombres son gestionados por ayatori, por lo que los llamadores que aún los nombran siguen resolviendo. | Obsoleto; los mismos espacios de nombres ahora se distribuyen desde ayatori |
Las etiquetas de estado describen los componentes compartidos de consulta en producción inspeccionados el 30 de agosto de 2026. Un pin de fuente o un benchmark aprobado no prueban por sí solos que una biblioteca atiende solicitudes en producción.