[GH-ISSUE #1312] Update deprecated '--index-url' to '--default-index' in uv commands #365

Closed
opened 2026-10-31 22:12:06 +00:00 by bsakaguchi · 1 comment
Owner

Originally created by @webfiltered on GitHub (Sep 11, 2025).
Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1312

Summary

The --index-url flag in uv has been deprecated and replaced with --default-index. The uv documentation explicitly marks this as "(Deprecated: use --default-index instead)".

Context

When using uv for Python package management, the --index-url option that was previously used to specify a custom package index URL has been deprecated. The new flag --default-index should be used instead for better alignment with uv's modern index management system.

Similarly, --extra-index-url is deprecated in favor of --index.

Impact

Any code or scripts in the ComfyUI Desktop codebase that currently use --index-url with uv commands should be updated to use --default-index to ensure compatibility with future versions of uv.

Migration Examples

Before (deprecated):

uv pip install --index-url https://pypi.org/simple/ package-name
uv pip install --extra-index-url https://custom.index/simple package-name

After (recommended):

uv pip install --default-index https://pypi.org/simple/ package-name
uv pip install --index https://custom.index/simple package-name

Action Required

  • Search codebase for any usage of --index-url with uv commands
  • Update to use --default-index instead
  • Search for --extra-index-url and update to --index
  • Test to ensure functionality remains the same
  • Consider migrating to pyproject.toml configuration for more complex index setups

References

┆Issue is synchronized with this Notion page by Unito

Originally created by @webfiltered on GitHub (Sep 11, 2025). Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1312 ## Summary The `--index-url` flag in uv has been deprecated and replaced with `--default-index`. The uv documentation explicitly marks this as "(Deprecated: use `--default-index` instead)". ## Context When using uv for Python package management, the `--index-url` option that was previously used to specify a custom package index URL has been deprecated. The new flag `--default-index` should be used instead for better alignment with uv's modern index management system. Similarly, `--extra-index-url` is deprecated in favor of `--index`. ## Impact Any code or scripts in the ComfyUI Desktop codebase that currently use `--index-url` with uv commands should be updated to use `--default-index` to ensure compatibility with future versions of uv. ## Migration Examples **Before (deprecated):** ```bash uv pip install --index-url https://pypi.org/simple/ package-name uv pip install --extra-index-url https://custom.index/simple package-name ``` **After (recommended):** ```bash uv pip install --default-index https://pypi.org/simple/ package-name uv pip install --index https://custom.index/simple package-name ``` ## Action Required - [ ] Search codebase for any usage of `--index-url` with uv commands - [ ] Update to use `--default-index` instead - [ ] Search for `--extra-index-url` and update to `--index` - [ ] Test to ensure functionality remains the same - [ ] Consider migrating to `pyproject.toml` configuration for more complex index setups ## References - [uv Package Indexes Documentation](https://docs.astral.sh/uv/concepts/indexes/) - [uv CLI Reference](https://docs.astral.sh/uv/reference/cli/) - The new system provides better control over index prioritization and explicit package sourcing ┆Issue is synchronized with this [Notion page](https://www.notion.so/Issue-1312-Update-deprecated-index-url-to-default-index-in-uv-commands-26b6d73d365081779b9eeb5b2b1e4feb) by [Unito](https://www.unito.io)
Author
Owner

@dosubot[bot] commented on GitHub (Dec 20, 2025):

Hi, @webfiltered. I'm Dosu, and I'm helping the desktop team manage their backlog and am marking this issue as stale.

Issue Summary:

  • You requested updating the ComfyUI Desktop codebase to replace deprecated uv command flags --index-url and --extra-index-url with the new --default-index and --index flags.
  • The goal is to maintain compatibility with uv's updated package index system and improve index prioritization.
  • This update would involve codebase-wide replacements, testing, and possibly migrating to pyproject.toml for more complex configurations.
  • There has been no further activity or comments on this issue since it was opened.

Next Steps:

  • Please let me know if this issue is still relevant with the latest version of the ComfyUI Desktop repository by commenting here.
  • If I do not hear back within 7 days, I will automatically close this issue.

Thank you for your understanding and contribution!

<!-- gh-comment-id:3677922858 --> @dosubot[bot] commented on GitHub (Dec 20, 2025): Hi, @webfiltered. I'm [Dosu](https://dosu.dev), and I'm helping the desktop team manage their backlog and am marking this issue as stale. **Issue Summary:** - You requested updating the ComfyUI Desktop codebase to replace deprecated uv command flags `--index-url` and `--extra-index-url` with the new `--default-index` and `--index` flags. - The goal is to maintain compatibility with uv's updated package index system and improve index prioritization. - This update would involve codebase-wide replacements, testing, and possibly migrating to `pyproject.toml` for more complex configurations. - There has been no further activity or comments on this issue since it was opened. **Next Steps:** - Please let me know if this issue is still relevant with the latest version of the ComfyUI Desktop repository by commenting here. - If I do not hear back within 7 days, I will automatically close this issue. Thank you for your understanding and contribution!
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Comfy-Org/desktop#365
No description provided.