shepherd

is an Aggregator.

It is part of the Translator collection.

Shepherd is a shared platform for NCATS Biomedical Data Translator Autonomous Relay Agents (ARAs), developed by the BioPack team. It runs the reasoning workflows of several ARAs (ARAGORN, ARAX, BioThings Explorer and SIPR) as operations on common infrastructure built from a message broker, a shared response store and per-operation workers, and it gets knowledge from Knowledge Providers through Retriever. Each hosted ARA has its own TRAPI endpoint and infores identifier.

License

Apache License 2.0 (inferred)

Homepage

shepherd

Repository

GitHub

External IDs

No external IDs available

Product Summary

Products

From this Resource
ID Name URL Category Format Description
shepherd.api Shepherd TRAPI API docs Programming Interface http Production Shepherd service (TRAPI 1....
shepherd.aragorn.api Shepherd ARAGORN TRAPI API docs Programming Interface http TRAPI query endpoint for the ARAGORN ...
shepherd.arax.api Shepherd ARAX TRAPI API docs Programming Interface http TRAPI query endpoint for the ARAX ARA...
shepherd.bte.api Shepherd BTE TRAPI API docs Programming Interface http TRAPI query endpoint for the BioThing...
shepherd.sipr.api Shepherd SIPR TRAPI API docs Programming Interface http TRAPI query endpoint for the SIPR ARA...
shepherd.code Shepherd Source Repository shepherd Process python Shepherd source code, with the server...
shepherd.docs Shepherd Documentation shepherd#readme Documentation http Project README describing Shepherd's ...

Details

BioPack Shepherd

Shepherd is a shared platform for Translator ARA implementation. Hosted ARAs share common functionality, such as query intake, response storage, merging, filtering and sorting of results, and they keep the ability to implement their own operations. Workers for each operation run as separate Docker services connected through a message broker.

Hosted ARAs

Each ARA has its own TRAPI endpoint under the production host and its own Information Resource identifier:

ARA Endpoint infores
ARAGORN https://shepherd.transltr.io/aragorn/ infores:shepherd-aragorn
ARAX https://shepherd.transltr.io/arax/ infores:shepherd-arax
BioThings Explorer https://shepherd.transltr.io/bte/ infores:shepherd-bte
SIPR https://shepherd.transltr.io/sipr/ infores:shepherd-sipr

The infores catalog lists each of these as consuming infores:retriever and being consumed by the ARS. Shepherd’s own OpenAPI document declares infores:shepherd, which was not in the infores catalog when checked on 2026-10-04.

Deployments

When checked on 2026-10-04, the production (https://shepherd.transltr.io/) and test (https://shepherd.test.transltr.io/) deployments ran version 1.1.7 with TRAPI 1.5.0, and the CI deployment (https://shepherd.ci.transltr.io/) ran version 1.2.1. The main branch of the repository targets TRAPI 2.0.

License

The repository had no license file when checked on 2026-10-04.

Is this information incorrect or incomplete? Request an update.

Created: October 04, 2026 | Last modified: October 04, 2026