mirror of
https://github.com/HKUDS/nanobot.git
synced 2026-05-20 08:32:25 +00:00
bad584cb0e
The webui bootstrap endpoint (/webui/bootstrap) rejected all non-localhost connections with HTTP 403, preventing the embedded webui from working when accessed from another device on the LAN — even when host was set to 0.0.0.0. Skip the localhost check when the server is explicitly bound to 0.0.0.0 or ::, since that signals intent to accept external connections.
119 lines
2.6 KiB
Markdown
119 lines
2.6 KiB
Markdown
# nanobot webui
|
|
|
|
The browser front-end for the nanobot gateway. It is built with Vite + React 18 +
|
|
TypeScript + Tailwind 3 + shadcn/ui, talks to the gateway over the WebSocket
|
|
multiplex protocol, and reads session metadata from the embedded REST surface
|
|
on the same port.
|
|
|
|
For the project overview, install guide, and general docs map, see the root
|
|
[`README.md`](../README.md).
|
|
|
|
## Current status
|
|
|
|
> [!NOTE]
|
|
> The standalone WebUI development workflow currently requires a source
|
|
> checkout.
|
|
>
|
|
> WebUI changes in the GitHub repository may land before they are included in
|
|
> the next packaged release, so source installs and published package versions
|
|
> are not yet guaranteed to move in lockstep.
|
|
|
|
## Layout
|
|
|
|
```text
|
|
webui/ source tree (this directory)
|
|
nanobot/web/dist/ build output served by the gateway
|
|
```
|
|
|
|
## Develop from source
|
|
|
|
### 1. Install nanobot from source
|
|
|
|
From the repository root:
|
|
|
|
```bash
|
|
pip install -e .
|
|
```
|
|
|
|
### 2. Enable the WebSocket channel
|
|
|
|
In `~/.nanobot/config.json`:
|
|
|
|
```json
|
|
{ "channels": { "websocket": { "enabled": true } } }
|
|
```
|
|
|
|
### 3. Start the gateway
|
|
|
|
In one terminal:
|
|
|
|
```bash
|
|
nanobot gateway
|
|
```
|
|
|
|
### 4. Start the WebUI dev server
|
|
|
|
In another terminal:
|
|
|
|
```bash
|
|
cd webui
|
|
bun install # npm install also works
|
|
bun run dev
|
|
```
|
|
|
|
Then open `http://127.0.0.1:5173`.
|
|
|
|
By default, the dev server proxies `/api`, `/webui`, `/auth`, and WebSocket
|
|
traffic to `http://127.0.0.1:8765`.
|
|
|
|
If your gateway listens on a non-default port, point the dev server at it:
|
|
|
|
```bash
|
|
NANOBOT_API_URL=http://127.0.0.1:9000 bun run dev
|
|
```
|
|
|
|
### Access from another device (LAN)
|
|
|
|
To use the webui from another device on the same network, set `host` to `"0.0.0.0"` in `~/.nanobot/config.json`:
|
|
|
|
```json
|
|
{
|
|
"channels": {
|
|
"websocket": {
|
|
"enabled": true,
|
|
"host": "0.0.0.0",
|
|
"port": 8765
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Then open `http://<your-ip>:8765` on the other device. When `host` is `"0.0.0.0"`, the bootstrap endpoint accepts requests from any source instead of restricting to localhost.
|
|
|
|
> **Note:** This exposes the gateway to all interfaces. Only use on trusted networks.
|
|
|
|
## Build for packaged runtime
|
|
|
|
```bash
|
|
cd webui
|
|
bun run build
|
|
```
|
|
|
|
This writes the production assets to `../nanobot/web/dist`, which is the
|
|
directory served by `nanobot gateway` and bundled into the Python wheel.
|
|
|
|
If you are cutting a release, run the build before packaging so the published
|
|
wheel contains the current WebUI assets.
|
|
|
|
## Test
|
|
|
|
```bash
|
|
cd webui
|
|
bun run test
|
|
```
|
|
|
|
## Acknowledgements
|
|
|
|
- [`agent-chat-ui`](https://github.com/langchain-ai/agent-chat-ui) for UI and
|
|
interaction inspiration across the chat surface.
|