Skip to content

Directory SDK

Libraries for interacting with Directory over gRPC: push records to the store, publish for routing, and search or pull by skill.

Available SDKs

SDK Language Package
Go SDK Go 1.21+ pkg.go.dev
Python SDK Python 3.10+ agntcy-dir on PyPI
JavaScript / TypeScript SDK Node.js (JS + TS) agntcy-dir on npm

Publish and discover

After pointing the client at a running Directory (localhost:8888 for the local daemon):

  1. Push an OASF record JSON to obtain a CID.
  2. Publish the CID to the routing layer for network discovery.
  3. Search by skill and pull matching records.

Use Quickstart to run dirctl daemon start locally. Remote servers require OIDC or SPIFFE configuration — see the per-SDK pages for details.

Protocol definitions: buf.build/agntcy/dir and API Reference.