Start Agent WebUI

Agent WebUI is served as a GraphOS co-service. This is the shortest path to a browser surface with the correct routing and authority boundaries.

Requirements

• Python 3.12 through 3.14
• A local or deployed epistemic-graph endpoint accepted by the generated GraphOS profile
• A supported model provider configured for conversations and agent runs

Install and run

uvx --from "graph-os[webui]" setup-config generate --profile tiny
export ENABLE_WEB_UI=true
uvx --from "graph-os[webui]" graph-os --transport streamable-http --host 127.0.0.1 --port 8000

Open http://127.0.0.1:8080. The MCP transport listens on port 8000; the WebUI co-service uses port 8080. Set GRAPH_OS_WEBUI_PORT when that port is already in use.

The successful first screen shows the Agent WebUI navigation and dashboard. Atlas at /explore presents the graph, object, schema, data, document, and memory entry points exposed by the connected runtime.

Local identity posture

A loopback-only local profile can run without SSO. Network exposure is a different security posture: configure the documented identity, host, origin, and TLS controls before binding publicly.

Work on the interface from source

Use the packaged GraphOS process for the backend, then run Vite for frontend changes:

git clone https://github.com/Knuckles-Team/agent-webui.git
cd agent-webui
pnpm install --frozen-lockfile
BACKEND_PORT=8080 pnpm run dev

Vite serves the development frontend at http://127.0.0.1:9000 and proxies API, ACP, and browser-control traffic to the GraphOS-hosted WebUI co-service.

Check the build

pnpm run typecheck
pnpm run test
pnpm run build

Continue with architecture for the request path or deployment and operations for production controls.