An OpenBYL field guide

tunnel 'n
here we are

How do you put a donkey on the internet when the donkey lives on your laptop?

Meet Beacon, Edge, and Burro, the local AI with surprisingly good reception.

A copper woodcut of Burro wearing a field-radio headset in a desert canyon, listening to a tower across the valley. Field radio
Burro, on relay duty.localhost:4747

The short version

The laptop
calls out.

OpenBYL builds tools you can run on your own machine. Burro runs there, too. The snag? localhost on your phone means your phone. A noble little misunderstanding.

So Beacon dials Edge, a public relay, and keeps an encrypted connection open. Visitors reach an OpenBYL web address. Edge sends their traffic down that connection to Beacon, which delivers it to the local app. The home router gets to keep its front door shut.

Beam lab

Send a request.

Follow a simulated request from your phone to Burro. The donkey remains seated.

Request traceaburro.openbyl.com
Standing by. Beam a request or choose a stop to inspect its job.

Field notes

Where does
the donkey live?

Both addresses reach the same public server. The hostname tells it where to find the answer.

This field guidePublic server

edge.openbyl.com

The public server keeps its own copy of this guide and serves the page directly. You can read it while the laptop takes a nap.

The local AI:4747

aburro.openbyl.com

Edge sends this request through the tunnel to Burro on the laptop. Burro asks for its own key at the door. Even a radio donkey checks the guest list.