Open Agent Spec <> AG‑UI (Python)
Agent runner that emits AG‑UI events and a small FastAPI/uvicorn server to stream them to Dojo via SSE.
What this is
- Agent runner:
ag_ui_agentspec/agent.pyexecutes an Agent Spec configuration on a chosen runtime and bridges spans to AG‑UI events. - Server wiring:
ag_ui_agentspec/endpoint.pyexposes a POST SSE endpoint that streams those events to the Dojo frontend.
Supported agent runtimes and Dojo features
- Wayflow (Oracle's reference agent framework) (chat, frontend tools, backend tools)
- LangGraph (chat, frontend tools, backend tools, tool call streaming)
Install
Base library plus optional extras so you can choose runtimes. Routers are lazy-loaded; if you don't install a runtime, its routes will not work.
Before installation, please clone the following GitHub repositories:
- AG-UI and
cd ag-ui/integrations/agent-spec/python - Agent Spec
- WayFlow
- Please put these 3 repos in the same directory.
# Wayflow only
uv pip install -e .[wayflow]
# LangGraph only
uv pip install -e .[langgraph]
# Multiple
uv pip install -e .[wayflow,langgraph]
Run the example server
cd ag-ui/integrations/agent-spec/python/examples
uv sync --extra langgraph --extra wayflow && uv run dev # both runtimes; serves http://localhost:9003
# or pick one runtime:
# uv sync --extra langgraph && uv run dev
# uv sync --extra wayflow && uv run dev
# then run Dojo (in a separate terminal):
# Option A — run everything from repo root (multiple apps):
# pnpm dev
# Option B — run only Dojo:
# cd ag-ui/apps/dojo
# AGENT_SPEC_URL=http://localhost:9003 pnpm dev (make sure to run pnpm build first)
Environment
- OpenAI-compatible variables commonly used by the examples (pick your provider):
OPENAI_BASE_URL(or provider-specific:OSS_API_URL,LLAMA_API_URL, etc.)OPENAI_MODEL(the model slug, defaults togpt-4oavailable through OpenAI API)OPENAI_API_KEY
- Dojo server URL:
AGENT_SPEC_URL=http://localhost:9003when running the local example server
Metadata
Release files for ag-ui-agent-spec 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ag_ui_agent_spec-0.2.0.tar.gz | 24.9 kB | Without provenance | Details for ag_ui_agent_spec-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ag_ui_agent_spec-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for ag_ui_agent_spec-0.2.0-py3-none-any.whl |
Total release size: 46.0 kB
Release files / ag_ui_agent_spec-0.2.0.tar.gz
| Download URL | ag_ui_agent_spec-0.2.0.tar.gz |
|---|---|
| Size | 24.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
107bd059c17835c515163b4b692864bdb4f68405ad7fe87f0fdc9474fe1450a5
|
|
BLAKE2b-256 checksum How to use checksums |
a7e7d906d058df18fdbed140ac775a1d9d499ac2dfa7ea6083c20a29e1a58eb6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / ag_ui_agent_spec-0.2.0-py3-none-any.whl
| Download URL | ag_ui_agent_spec-0.2.0-py3-none-any.whl |
|---|---|
| Size | 21.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a16fd26fdcea873c6e969edeb42d6606ee0056fbec3cec3aef07475a14cc68f2
|
|
BLAKE2b-256 checksum How to use checksums |
f1fbfd9ef0ba1cc6c17183c16702e6f7143240ba2baa8f0bc78017ea1fe6511a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for ag-ui-agent-spec 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.