You can render the specification from YAML to HTML using python yaml-to-html.py < ../beacon.yaml > beacon.html Open then beacon.html in your web browser. The output looks like a Swagger page.