Skip to content

install: Windows users without Python/uv/Git have no one-command install path (PowerShell) #2308

Description

@Q00

Problem

scripts/install.sh is bash-only and requires uv, pipx, or Python >= 3.12 to already exist (scripts/install.sh step 1/4 never bootstraps uv). A Windows machine with none of them cannot install Ouroboros without first setting up WSL 2 or a Python toolchain by hand. The README only shows the curl | bash one-liner.

The Claude Code plugin path does not actually need a system Python: .claude-plugin/.mcp.json launches the MCP server through uvx --python '>=3.12', skills fall back to uv run, and hooks fail open. The real prerequisites on native Windows are Git and uv.

Proposed

A scripts/install.ps1 runnable as irm .../install.ps1 | iex on PowerShell 5.1+ that installs Git and uv through winget when missing, runs uv tool install ouroboros-ai with the same pins as install.sh, and wires setup + the Claude Code plugin. README/getting-started should show both one-liners.

Related: #2050 (single-file exe distribution — a different, longer-term path).

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or meaningful improvement

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions