DEVELOPERS

Ship Healthcare Integrations
in Days, Not Quarters.

Built on the OpenHIE (Open Health Information Exchange) mediator pattern for standards-compliant Health Information Exchange. Discover agents from the Global Healthcare Agent Registry and Routing Architecture (GHARRA), and connect clinical systems through the Nexus Agent-to-Agent (A2A) protocol.

Quick Start API Reference Authentication
QUICK START

Three steps to your first integration.

From discovery to deployment in minutes. BulletTrain's OpenHIE-compliant orchestration layer handles interoperability so you can focus on your workflow. Every code snippet below runs against the real APIs.

1. Discover an agent — Python
from gharra import RegistryClient

client = RegistryClient("https://registry.symphonix.health")
agents = client.discover(
    capability="fhir-r4-patient-search",
    region="eu-west-1"
)
print(agents[0].name, agents[0].endpoint)
2. Send a task — Python (JSON-RPC via Nexus)
import httpx

response = httpx.post(
    agents[0].endpoint,
    json={
        "jsonrpc": "2.0",
        "method": "tasks/send",
        "params": {"query": "Find patient by MRN 00412"},
        "id": 1
    }
)
print(response.json()["result"])
3. Launch all agents — Bash
git clone https://github.com/symphonix-health/bullettrain.git
cd bullettrain && pip install -e ".[all]"
python -m bullettrain.launch --all-agents
HOW IT WORKS

The Integration Lifecycle

Four steps from raw clinical data to guaranteed delivery — fully governed, fully auditable.

Connect

Plug into clinical systems via FHIR, HL7, CDA, X12, DICOM adapters.

Classify

BulletTrain automatically classifies data as clinical, operational, or containing patient data.

Route

Governed routing to the right destination with full audit trail.

Deliver

Guaranteed delivery with circuit breakers, dead-letter recovery, and event replay.

ENDPOINTS

API Surface Preview

A snapshot of the core endpoints. Enough to start building — full reference in the architecture docs.

Endpoint Method Description
/v1/agents POST Register an agent in the Global Agent Registry
/v1/discover GET Discover agents by capability and jurisdiction
/v1/route POST Get routing advisory with full trust bundle
/tasks/send POST Send a task to another agent via Nexus
/tasks/get GET Poll task status and retrieve results
/health GET Agent health check
PROTOCOLS & STANDARDS

Built on open standards.

FHIR R4 HL7v2 CDA X12 DICOM JSON-RPC 2.0 SSE WebSocket
PLATFORM

Build on governed infrastructure.

BulletTrain is free to deploy. GHARRA is a managed agent registry. Nexus A2A is the secure communication protocol that connects them.

Nexus Agent-to-Agent Protocol

PROTOCOL

JSON-RPC 2.0 protocol for secure inter-agent communication in healthcare. Server-Sent Events (SSE), WebSocket transport, 13-point route admission validation.

Global Agent Registry (GHARRA)

MANAGED SERVICE

Federated registry for healthcare AI agents. Discover, register, and route to agents across organisational boundaries. Hosted by Symphonix Health — pay per agent usage.

DOCUMENTATION

Everything you need to ship.

Comprehensive guides, API references, and protocol specifications.

PROGRAMMING INTERFACES

Four ways to integrate. One platform.

Every programming interface — REST, MCP, Nexus A2A, and the Python SDK — is fully documented in the API Reference.

Full API Reference Book a 30-Minute Architecture Walkthrough

Start building.

Clone the repos, run the quick start, and ship your first healthcare integration today.

View on GitHub Read the Docs

Live demos: Cross-Border Orchestration • Agent Network Topology