Skip to content

docs: use --prerelease=explicit for install instructions#2971

Closed
zzstoatzz wants to merge 1 commit intomainfrom
docs/fix-prerelease-install
Closed

docs: use --prerelease=explicit for install instructions#2971
zzstoatzz wants to merge 1 commit intomainfrom
docs/fix-prerelease-install

Conversation

@zzstoatzz
Copy link
Copy Markdown
Collaborator

Using --prerelease=allow when installing fastmcp can pull in prerelease versions of dependencies like httpx. httpx 1.0.dev* removes TransportError which breaks httpx-sse, which breaks mcp imports.

--prerelease=explicit only allows prereleases for packages explicitly requested with a prerelease specifier (like fastmcp>=3.0a0), keeping dependencies on stable versions.

# before (could install httpx==1.0.dev3)
uv add fastmcp --prerelease=allow

# after (installs httpx==0.28.1 stable)
uv add "fastmcp>=3.0a0" --prerelease=explicit

🤖 Generated with Claude Code

@marvin-context-protocol marvin-context-protocol Bot added the documentation Updates to docs, examples, or guides. Primary change is documentation-related. label Jan 21, 2026
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlowin
Copy link
Copy Markdown
Member

jlowin commented Jan 22, 2026

pip install "fastmcp>=3.0.0b1" --pre is still problematic (gets the bad httpx version) -- but it turns out pip install 'fastmcp>=3.0.0b1' is fine! Going to close this and adopt that in #2975. Thanks!

@jlowin jlowin closed this Jan 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Updates to docs, examples, or guides. Primary change is documentation-related.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants