libreyolo ui

Starts a local web server that accepts dropped or pasted images, runs a chosen model on them, and shows the results in the browser.

Command
libreyolo ui
Output
A server URL on stdout, then the process stays in the foreground

Synopsis

bash
libreyolo ui [key=value ...]

Arguments are key=value pairs, and POSIX form works too, so port=9000 and --port 9000 are the same argument.

Arguments

ArgumentDefaultMeaning
host127.0.0.1Host or interface to bind
port8000Port to bind. Bumps to the next free one if taken
deviceautoDevice: 0, cpu, mps, auto
no_browserfalseDo not auto-open the browser
jsonfalseJSON output to stdout
quietfalseSuppress stderr
verbosefalseVerbose stderr output

Examples

Basic
libreyolo ui
Fixed port, no browser
libreyolo ui port=9000 no_browser=true
On the CPU, machine readable
libreyolo ui device=cpu json=true

Notes

The default bind is loopback, so the UI is reachable from this machine only.

If the requested port is in use, the command tries the next one and keeps going up to twenty ports past the request. Failing all twenty exits with io_error and the suggestion to pass a different port. The URL printed on stdout is the port that was actually bound, so read it rather than assuming the one you asked for.

Unless no_browser=true, a browser tab opens at that URL shortly after the bind.

The command then serves in the foreground until Ctrl+C, which shuts the server down cleanly. There is no detached mode; background it with your shell if you want the terminal back.

json=true prints the URL and device as one object with schema_version before the server starts, which is how a script picks up the bound port.

Related: libreyolo label for drawing boxes and saving labels, libreyolo monitor for watching training runs. Both are local web servers with the same port and browser behavior.

Verified against LibreYOLO v1.5.0.