使用 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 或检查版本兼容性。

相关推荐
IT规划师9 天前
Redis 数据类型全解 - HyperLogLog:12 KB 估出亿级 UV(八)
redis·uv·hyperloglog·.net10
Martina_032113 天前
AI生成3D模型一合并网格,材质就串色?用6步检查材质槽、UV与图集重映射
图像处理·人工智能·3d·材质·uv·游戏策划·1024程序员节
我不会起名字32214 天前
Redis 从 0 到 1(十六):1 亿 UV 只占 12KB?计数去重三件套的 Go 实测
redis·go·uv·布隆过滤器·hyperloglog
2601_9611462017 天前
实验室等离子表面处理设备安全整改记录:通风、UV、接地三项
笔记·安全·uv
毒爪的小新17 天前
最新 Dify 1.14.0+ 内网离线插件打包、部署完整踩坑方案(解决 uv.lock 依赖校验失败)
运维·ai·uv·dify
醇氧18 天前
CentOS7 使用 uv 安装 Python3.11.9 生产部署文档
uv·python3.11
工业涂料百问25 天前
水性、粉末、UV、溶剂型怎么选?一张对照表看清四条涂层路线的边界
uv
AI 编程助手GPT1 个月前
GPT 脚本别只发一个文件:用 uv 把依赖和锁一起交付
人工智能·python·gpt·uv·依赖管理
Martina_03211 个月前
AI生成3D模型UV岛太碎,重绘贴图全是接缝?用6步重整UV并保留原材质
图像处理·人工智能·3d·自然语言处理·贴图·uv·游戏策划