build(client): use locked uv environment in launcher and Docker

README.md

@@ -14,7 +14,7 @@ documentation, source identifiers, comments, and internal instructions use Engli
 Start with [client setup and usage](docs/client/usage.md), then read the
 [architecture](docs/client/architecture.md) and [documentation index](docs/README.md).
 The speech backend needs its own installed model and runtime dependencies;
-`s2s-client/requirements.txt` installs only the UI server dependencies.
+The uv project in `s2s-client/` installs only the UI server dependencies.
 
 ## Run the browser client
 
@@ -25,13 +25,13 @@ S2S_PROXY_TARGET=ws://localhost:8765/v1/realtime ./start_ui.sh
 ```
 
 Open <http://localhost:8420/> and allow microphone access. The launcher creates
-`.venv`, installs missing Python requirements and locked frontend dependencies,
+`s2s-client/.venv`, syncs locked Python and frontend dependencies,
 and loads the root `.env` if present. Vite listens on `UI_PORT` (default `8420`)
 and forwards HTTP/WebSocket backend routes to FastAPI on `127.0.0.1:8421`.
 Both servers reload during development; stopping the launcher stops both.
 Leave `SPEECH_TO_SPEECH_URL` unset to use the same-origin speech proxy.
 
-The launcher requires Python 3 with venv support, Node.js 22.18+ on the 22.x
+The launcher requires uv 0.12.5 (which provisions Python 3.12), Node.js 22.18+ on the 22.x
 line or Node.js 24+, npm, Bash 4.4+, `setsid`, and `curl`. For staging hostnames,
 set `S2S_DEV_ALLOWED_HOSTS` and forward the Vite HMR WebSocket through the existing
 HTTPS reverse proxy. See [development setup](s2s-frontend/README.md).
@@ -52,6 +52,7 @@ proxy deployment, supply a backend address reachable from the container instead.
 ## Project references
 
 - [Change history](s2s-client/CHANGELOG.md)
+- [Backend development and compatibility](docs/client/development.md)
 - [Realtime protocol and pipeline](docs/speech/realtime-api.md)
 - [Context injection](docs/client/context-injection.md)
 - [Tool calling](docs/client/tool-calling.md)