Agent WebUI
The browser workspace for governed agents, workflows, and knowledge in GraphOS.
Overview
Agent WebUI turns GraphOS into an operator-facing product. It provides one React workspace for agent conversations, approvals, workflows, fleet activity, and epistemic-graph exploration. Its FastAPI host keeps privileged credentials and GraphOS delegation on the server side.
| This repository owns | Other components own |
|---|---|
| Browser presentation, local interaction state, accessible route composition, and the WebUI FastAPI boundary | GraphOS owns public routing, identity, policy, and fleet supervision; agent-utilities owns agent behavior; epistemic-graph owns durable knowledge; connector services own external-system effects |
Current package Version: 2.6.1.
Key Capabilities
- Stream agent responses with sources, governed tool activity, and approval prompts.
- Build and run workflows while observing sessions, goals, schedules, and fleet health.
- Explore property graphs, RDF, schemas, objects, tables, documents, code, and memories through Atlas.
- Discover MCP Apps and connector capabilities without exposing service credentials to the browser.
- Apply one role-aware navigation and server authorization model across the complete workspace.
- Run as the GraphOS-hosted browser co-service or as an independently deployed ASGI application.
Documentation
Start with the Agent WebUI documentation, then use the shared platform map to move between components:
| Component | Role | Documentation |
|---|---|---|
| GraphOS | Public MCP, REST, A2A, identity, policy, and runtime composition | Docs |
| agent-utilities | Agent decisions, workflows, evaluation, and skills | Docs |
| epistemic-graph | Durable multimodal data, reasoning, provenance, and transactions | Docs |
| agent-connector-sdk | Typed source adapters, connector serving, and write-back contracts | Docs |
Project telemetry
Architecture
The browser talks only to its same-origin FastAPI host. GraphOS injects the gateway routes and verified request context before the single-page application is mounted. The UI renders typed responses and records local presentation state; it does not become a second authority for policy, knowledge, or connector state.
See the architecture guide for the request flow and trust boundaries.
Quick Start
Generate a local profile and launch GraphOS with the WebUI integration:
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. GraphOS serves MCP on port 8000 and the WebUI
co-service on port 8080. The start guide
covers local source development and deployment profiles.
Contributing
Issues and pull requests are welcome. Read AGENTS.md, keep browser and server authority boundaries intact, and run the repository validation suite before opening a pull request.
License
Agent WebUI is available under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for agent-webui 2.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agent_webui-2.6.1.tar.gz | 5.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_webui-2.6.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.2 MB
Release files / agent_webui-2.6.1.tar.gz
| Download URL | agent_webui-2.6.1.tar.gz |
|---|---|
| Size | 5.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dceac11f69b504d2aba90c39227afe9feadcc8659855963a955f3fc149290e7f
|
|
BLAKE2b-256 checksum How to use checksums |
3eab8230e2ca843fa7e8fe88184acab19d77d3bc51a9f95f7323d6a685a40096
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / agent_webui-2.6.1-py3-none-any.whl
| Download URL | agent_webui-2.6.1-py3-none-any.whl |
|---|---|
| Size | 5.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aaefefa42f8d31de81b2bcee51d34f7b99febd8cc60b5e352decb3d1958e1978
|
|
BLAKE2b-256 checksum How to use checksums |
f6e3e0fe0d500e6b52832a508c14fc08ccb9d7b0e8efa8d258da81512c04f68e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
