使用 uv 根据 requirements.txt 创建并应用虚拟环境

使用 uv 根据 requirements.txt 创建并应用虚拟环境，请按以下步骤操作（假设你已安装 uv，若未安装可先通过 pip install uv 或官方脚本安装）。

---

1️⃣ 创建虚拟环境（指定 Python 版本）

由于你的 requirements.txt 中 Python 版本为 3.13.9，建议在创建时明确指定：

uv venv --python 3.13

这会在当前目录生成一个 .venv 文件夹（默认名称）。

如果系统已安装 Python 3.13.9，uv 会自动使用它；否则会提示安装。

---

2️⃣ 激活虚拟环境

• Linux / macOS：

  source .venv/bin/activate

• Windows (CMD)：

  .venv\Scripts\activate.bat

• Windows (PowerShell)：

  .venv\Scripts\Activate.ps1

激活后，终端提示符前会出现 (.venv)，表示当前处于虚拟环境中。

---

3️⃣ 安装 requirements.txt 中的依赖

在激活状态下执行：

uv pip install -r requirements.txt

uv 会利用缓存和并行解析，速度远超传统 pip。安装完成后，所有依赖（包括 gradio==6.20.0、llama-index 等）都会被锁定到虚拟环境中。

---

4️⃣ 验证安装（可选）

uv pip list

或查看特定包：

uv pip show gradio

---

5️⃣ 应用虚拟环境（运行项目）

在激活状态下，直接运行你的 Python 脚本或启动 Web UI：

python your_app.py

或者如果使用 Gradio 启动文件，比如：

python app.py

---

💡 补充说明

• 若不想每次手动激活 ，可在执行命令时直接用 uv 调用虚拟环境中的 Python，例如：

  uv run python your_app.py

  uv run 会自动使用当前目录下 .venv 中的解释器，无需激活。

• 如果你有 pyproject.toml ，可改用 uv sync 更高效，但当前只有 requirements.txt，所以使用 uv pip install -r 完全足够。

• 注意依赖冲突 ：numpy<2.4 等限制条件会被 uv 严格处理，若出现问题可尝试加 --resolution lowest 或检查版本兼容性。