The protocol

Read this first before writing a single line of code.

Protocol specification (v1.0): https://github.com/fredabila/oahl/blob/main/docs/oahl-protocol-v1.md

OpenAPI contract: https://github.com/fredabila/oahl/blob/main/openapi.yaml

Architecture overview: https://github.com/fredabila/oahl/blob/main/docs/architecture.md

The repository

Everything is open source.

Main repo: https://github.com/fredabila/oahl

Adapter examples (webcam, Android/ADB, SDR, mock): https://github.com/fredabila/oahl/tree/main/examples

Transport plugin SDK: https://github.com/fredabila/oahl/blob/main/docs/transport-plugin-architecture.md

Adapter writing guide: https://github.com/fredabila/oahl/blob/main/docs/adapter-guide.md

Security and policy guide: https://github.com/fredabila/oahl/blob/main/docs/security-guide.md

Agent integration guide: https://github.com/fredabila/oahl/blob/main/docs/agent-integration-guide.md

The cloud endpoint and registry

You do not need to run your own cloud instance. Use the hosted registry for discovery, reservation, and relay during development and your demo.

Cloud API base URL: https://oahl.onrender.com

Registry and marketplace: https://registry.oahl.dev

Project site: https://oahl.dev

Validate your adapter before submitting

Run the conformance CLI against your adapter to confirm it passes all seven protocol targets:

npx oahl-conformance

All seven targets must pass for your submission to be considered complete.