docs(examples): the agui-events service needs the [api] extra - #77
Merged
Conversation
The README's own command omits --extra api, so a clean checkout dies on ModuleNotFoundError: No module named 'ag_ui'. mcp_agent_api ships in the base wheel and imports far enough to look installed; ag-ui-protocol, which events.py needs, is in the extra. Also corrects "four routes" to five, unchanged since #73. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
ciaransweet
pushed a commit
that referenced
this pull request
Aug 13, 2026
🤖 I have created a release *beep* *boop* --- ## [0.5.5](mcp-toolsets-runtime-v0.5.4...mcp-toolsets-runtime-v0.5.5) (2026-08-13) ### Documentation * **examples:** the agui-events service needs the [api] extra ([#77](#77)) ([c76a274](c76a274)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). Co-authored-by: ds-release-bot[bot] <116609932+ds-release-bot[bot]@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The command this README gives cannot start the service from a clean checkout.
mcp_agent_apiships in the base wheel, so the import gets as far asmcp_agent_api.events, which importsag_ui. That comes fromag-ui-protocol, which lives in the[api]extra — and the command never asksfor it.
uv runbuilds the environment from the command alone, so a freshclone installs 71 packages and dies on:
A checkout developed with
uv sync --all-extrasalready has the extra andnever sees this, which is how it survived.
The change
--extra apion the command, plus a paragraph saying why it is not optional —the failure names
ag_uirather than the extra, andmcp_agent_apiimportingfar enough to look installed is exactly what makes it confusing.
One extra is enough:
api = ["mcp-toolsets-runtime[agent]", "ag-ui-protocol"],so
[agent]arrives with it. 78 packages against 71.Verified in a throwaway environment rather than the repo's own venv, since the
symptom only reproduces where the extra is absent. With it the service boots:
connected 4 MCP server(s),built on mistral-small-latest: 5 tool(s), 1 withheld, and/health/readinessanswers 200{"status": "ready"}.Also corrects "the agent's four routes" to five, twenty lines down. It has been
five since #73 —
service/app.py's docstring was corrected then and this wasmissed.
Reported by a colleague hitting it on a first run, which is the only place it
can be hit.
🤖 Generated with Claude Code