使用 uv 从 GitHub 安装 Python 依赖：以 litellm 为例

背景 #

在 Python 项目中，通常使用 pip 或 Poetry 来管理依赖。但当依赖项没有发布到 PyPI，或者你需要安装特定的 GitHub 分支时，默认的 pip install 方式可能不够优雅。uv 是一个超快的 Python 包管理工具，支持 pyproject.toml，并且可以直接从 GitHub 安装依赖。

本文介绍如何使用 uv 从 GitHub 安装 litellm，并确保 pyproject.toml 和 uv.lock 文件正确更新。

操作步骤 #

1. 初始化 uv 项目 #

如果你的项目还没有 pyproject.toml，可以使用 uv init 进行初始化：

uv init

然后按照提示输入项目名称、Python 版本等信息。

2. 使用 uv add 添加 GitHub 依赖 #

如果你想安装 litellm 的 feature/add_openrouter_api_base 分支，可以执行：

uv add git+https://github.com/graysonchen/litellm.git@feature/add_openrouter_api_base

这条命令会：

• 安装 litellm 的 feature/add_openrouter_api_base 分支。
• 自动更新 pyproject.toml 和 uv.lock 文件。

3. 确认 pyproject.toml 配置 #

uv add 执行后，你的 pyproject.toml 会自动更新，类似于：

[tool.uv.dependencies]
litellm = { git = "https://github.com/graysonchen/litellm.git", rev = "feature/add_openrouter_api_base" }

如果需要手动添加 GitHub 依赖，可以直接修改 pyproject.toml，然后运行：

uv sync

以确保 uv.lock 也被更新。

4. 验证安装 #

你可以使用以下命令检查 litellm 是否安装成功：

uv pip freeze | grep litellm

如果成功，应该会看到 litellm 相关的安装记录。

总结 #

✅ uv 支持直接安装 GitHub 依赖，避免 pip install 需要手动维护 requirements.txt。 ✅ uv add 会自动更新 pyproject.toml 和 uv.lock，保证依赖管理的一致性。 ✅ 适用于安装未发布到 PyPI 的 Python 包，或是需要特定 GitHub 分支的版本。