Skip to content

docs: add uv as alternative installation option#874

Open
MasahiroOgawa wants to merge 3 commits into
state-spaces:mainfrom
MasahiroOgawa:feature/uv
Open

docs: add uv as alternative installation option#874
MasahiroOgawa wants to merge 3 commits into
state-spaces:mainfrom
MasahiroOgawa:feature/uv

Conversation

@MasahiroOgawa
Copy link
Copy Markdown

Summary

Add uv as an alternative installation option alongside existing pip instructions.

  • Restructure Installation section into Option A: pip (unchanged) and Option B: uv
  • Step-by-step guide: venv creation, PyTorch CUDA install, building from source
  • Explains why uv pip install (not uv add) is needed (setup.py imports torch at build time)

No code changes — documentation only.

Motivation

uv is becoming a popular Python package manager due to significantly faster dependency resolution and installs. Adding it as an option helps users who already use uv in their workflow.

Test plan

  • Verified the uv installation steps work end-to-end on RTX 4080 with CUDA 12.8
  • Confirmed mamba-ssm builds and loads correctly via uv-installed environment

🤖 Generated with Claude Code

MasahiroOgawa and others added 3 commits March 23, 2026 16:37
Add Option B (uv) alongside existing pip instructions. uv provides
faster dependency resolution and installs. The guide covers venv
creation, PyTorch CUDA install, and building mamba-ssm from source.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
uv.lock is environment-specific (pins exact versions for a particular
CUDA/Python setup) and should not be committed.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…hon version

- .gitignore: add missing trailing newline
- README: remove hardcoded --python 3.12, add source .venv/bin/activate step

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant