uv-remove

Remove dependencies from a uv project

Remove dependency

$ uv remove [package]

Remove dev dependency

$ uv remove --dev [package]

Remove from optional group

$ uv remove --optional [group] [package]

uv remove [options] packages...

uv remove removes dependencies from a Python project. Updates pyproject.toml and uv.lock. Automatically syncs the virtual environment.

--dev

Remove the package from the [tool.uv.dev-dependencies] group.

--optional GROUP

Remove from the named optional dependency group in pyproject.toml.

--group GROUP

Remove from the named PEP 735 dependency group.

--script SCRIPT.PY

Operate on the dependency block of a single-file PEP 723 script instead of the project.

--package PACKAGE

In a workspace, target the package member named PACKAGE.

--frozen

Update pyproject.toml but leave uv.lock unchanged.

--locked

Fail if uv.lock would need to change (CI guard).

--no-sync

Skip syncing the project's virtual environment after the change.