Quickstart

This path validates and runs the reference implementation locally. For a pilot registry with retained evidence, use the 15-minute quickstart. For a complete release gate, use the Candidate Specification implementation guide. Compare all journeys in Start Here.

Local validation

make setup
make validate
make test

Run the reference service

make run

The service listens on http://127.0.0.1:8000. Retrieve registry metadata:

curl http://127.0.0.1:8000/registry

Register the example agent:

curl -X POST http://127.0.0.1:8000/agents \
  -H 'Content-Type: application/json' \
  --data @examples/valid/agent-core.json

Resolve it:

curl http://127.0.0.1:8000/agents/agentreg:example.org:agent-123

The reference service is an interoperability aid, not a production deployment or trust certification service.