Installing & Running webAgent

The recommended path uses uv (a fast Python/environment manager) so you don't have
to manage Python versions yourself.

• Windows, easiest: use the desktop launcher — it can install everything from

scratch and gives you Launch/Stop buttons (see The Server-Manager TUI & Launchers).
Or double-click the included Windows batch file, which installs uv, syncs dependencies,
and starts the server with auto-restart.

• Mac / Linux: install uv, run a sync (which fetches a matching Python and all

dependencies), then start the server. A background start script with logging is
included.

• Android: a Termux-based launcher handles the unusual phone setup.

Once running, the app is at http://localhost:8080/. Other handy local URLs include the
API docs, the standalone diagnostics page, and the wiki API.

First run notes: the app creates its own local database automatically — no database
setup needed to get started (it uses a simple file-based store by default). Browser
control downloads a browser the first time. Everything can be reconfigured later from
App Config.

For what hardware/OS is supported, see Supported Devices & Platforms. For choosing
models, see Models & Providers.