HomeTube本地安装指南pip、conda、uv三种方式对比与常见避坑清单【免费下载链接】hometubeHomeTube is a friendly video downloader managing single video URL into organized content structure for automatic home media server experience.项目地址: https://gitcode.com/gh_mirrors/ho/hometubeHomeTube 是一个开源的本地视频下载工具粘贴链接即可自动下载最高画质、跳过赞助片段的视频并按照 Plex、Jellyfin 等媒体服务器的目录规范自动整理归档。本文对比 pip、conda、uv 三种 HomeTube 本地安装方式并附上新手最常见的避坑清单帮你在 10 分钟内完成部署。 安装前准备先确认这 4 项在开始之前请确认系统满足以下条件版本要求见 pyproject.toml依赖项要求说明Python3.11核心运行环境FFmpeg任意近期版本视频处理与流合并必备yt-dlp最新稳定版真正的下载引擎.env 文件必须由.env.sample复制而来系统层依赖安装# Ubuntu / Debian sudo apt update sudo apt install python3 python3-pip ffmpeg # macOSHomebrew brew install python ffmpeg Windows 用户安装 Python 3.11记得勾选 Add to PATH再下载 FFmpeg 并加入 PATH。 第一步获取源码并初始化配置三种方式都要先执行以下命令尤其是.env这一步 ⚠️git clone https://gitcode.com/gh_mirrors/ho/hometube cd hometube cp .env.sample .env # ⚠️ 必做没有 .env 应用无法正常启动.env中可以自定义下载目录、界面语言、音频与字幕语言等完整示例见 .env.sample。 方式一pip venv标准方式最通用适合已经熟悉 pip 的新手任何系统都能跑通。python -m venv .venv source .venv/bin/activate # Windows 用.venv\Scripts\activate pip install -e .[local] # 核心依赖 yt-dlp 下载引擎安装完成后可运行make test见 Makefile验证环境是否完好。 方式二conda已有 Anaconda/Miniconda 的用户项目自带 environment.yml一键创建含 FFmpeg 的完整环境省去系统依赖的麻烦conda env create -f environment.yml conda activate hometube pip install -e .[local]如果只想装最精简的运行环境conda create -n hometube python3.11 ffmpeg -y conda activate hometube pip install -e .[local]⚡ 方式三uv速度最快推荐uv 是一个极速的 Python 包管理器。项目已提供锁定的 uv.lock所有依赖版本精确固定可复现性最好uv sync # 一条命令自动建虚拟环境并装好全部依赖 uv run streamlit run app/main.py # 直接启动无需手动激活环境⚖️ 三种安装方式怎么选对比维度pip venvcondauv上手难度⭐ 简单⭐⭐ 需先装 Conda⭐ 简单安装速度常规常规最快数秒级环境隔离venv 手动隔离独立环境可连 FFmpeg 一起装自动管理虚拟环境版本锁定依赖 pyproject.toml依赖 pyproject.tomluv.lock 精确锁定适合人群所有新手已有 Conda 环境的用户追求速度与可复现性一句话建议纯新手选 pip/venv 或 uv已用 Conda 选 conda追求效率和版本一致就选 uv。 启动与验证streamlit run app/main.py # uv 用户uv run streamlit run app/main.py浏览器打开http://localhost:8501粘贴一个公开视频链接测试下载确认文件按.env中VIDEOS_FOLDER的设定正确归档。安装成功后的 HomeTube 视频下载工具 Web 界面如下 常见避坑清单新手最容易踩的 6 个坑忘记创建 .env应用启动异常——必须执行cp .env.sample .env这是本地安装的第一步。FFmpeg not found——未安装 FFmpeg 或不在 PATH 中用ffmpeg -version验证Linux 用 apt、macOS 用 brew 安装。yt-dlp 缺失或版本过旧——HomeTube 依赖 yt-dlp 解析链接务必与主程序装在同一个虚拟环境中并定期更新。Windows 激活命令写错——请用.venv\Scripts\activateLinux/macOS 的source命令在 Windows 上无效。Python 版本低于 3.11——用python --version检查旧版本会导致依赖安装失败。8501 端口被占用——修改.env中的PORT值后重启即可。 延伸阅读完整安装与 Docker 部署方案docs/installation.md生产环境部署与反向代理docs/deployment.md依赖清单由 uv 生成requirements/requirements.txt【免费下载链接】hometubeHomeTube is a friendly video downloader managing single video URL into organized content structure for automatic home media server experience.项目地址: https://gitcode.com/gh_mirrors/ho/hometube创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 HomeTube本地安装指南：pip、conda、uv三种方式对比与常见避坑清单
HomeTube本地安装指南pip、conda、uv三种方式对比与常见避坑清单【免费下载链接】hometubeHomeTube is a friendly video downloader managing single video URL into organized content structure for automatic home media server experience.项目地址: https://gitcode.com/gh_mirrors/ho/hometubeHomeTube 是一个开源的本地视频下载工具粘贴链接即可自动下载最高画质、跳过赞助片段的视频并按照 Plex、Jellyfin 等媒体服务器的目录规范自动整理归档。本文对比 pip、conda、uv 三种 HomeTube 本地安装方式并附上新手最常见的避坑清单帮你在 10 分钟内完成部署。 安装前准备先确认这 4 项在开始之前请确认系统满足以下条件版本要求见 pyproject.toml依赖项要求说明Python3.11核心运行环境FFmpeg任意近期版本视频处理与流合并必备yt-dlp最新稳定版真正的下载引擎.env 文件必须由.env.sample复制而来系统层依赖安装# Ubuntu / Debian sudo apt update sudo apt install python3 python3-pip ffmpeg # macOSHomebrew brew install python ffmpeg Windows 用户安装 Python 3.11记得勾选 Add to PATH再下载 FFmpeg 并加入 PATH。 第一步获取源码并初始化配置三种方式都要先执行以下命令尤其是.env这一步 ⚠️git clone https://gitcode.com/gh_mirrors/ho/hometube cd hometube cp .env.sample .env # ⚠️ 必做没有 .env 应用无法正常启动.env中可以自定义下载目录、界面语言、音频与字幕语言等完整示例见 .env.sample。 方式一pip venv标准方式最通用适合已经熟悉 pip 的新手任何系统都能跑通。python -m venv .venv source .venv/bin/activate # Windows 用.venv\Scripts\activate pip install -e .[local] # 核心依赖 yt-dlp 下载引擎安装完成后可运行make test见 Makefile验证环境是否完好。 方式二conda已有 Anaconda/Miniconda 的用户项目自带 environment.yml一键创建含 FFmpeg 的完整环境省去系统依赖的麻烦conda env create -f environment.yml conda activate hometube pip install -e .[local]如果只想装最精简的运行环境conda create -n hometube python3.11 ffmpeg -y conda activate hometube pip install -e .[local]⚡ 方式三uv速度最快推荐uv 是一个极速的 Python 包管理器。项目已提供锁定的 uv.lock所有依赖版本精确固定可复现性最好uv sync # 一条命令自动建虚拟环境并装好全部依赖 uv run streamlit run app/main.py # 直接启动无需手动激活环境⚖️ 三种安装方式怎么选对比维度pip venvcondauv上手难度⭐ 简单⭐⭐ 需先装 Conda⭐ 简单安装速度常规常规最快数秒级环境隔离venv 手动隔离独立环境可连 FFmpeg 一起装自动管理虚拟环境版本锁定依赖 pyproject.toml依赖 pyproject.tomluv.lock 精确锁定适合人群所有新手已有 Conda 环境的用户追求速度与可复现性一句话建议纯新手选 pip/venv 或 uv已用 Conda 选 conda追求效率和版本一致就选 uv。 启动与验证streamlit run app/main.py # uv 用户uv run streamlit run app/main.py浏览器打开http://localhost:8501粘贴一个公开视频链接测试下载确认文件按.env中VIDEOS_FOLDER的设定正确归档。安装成功后的 HomeTube 视频下载工具 Web 界面如下 常见避坑清单新手最容易踩的 6 个坑忘记创建 .env应用启动异常——必须执行cp .env.sample .env这是本地安装的第一步。FFmpeg not found——未安装 FFmpeg 或不在 PATH 中用ffmpeg -version验证Linux 用 apt、macOS 用 brew 安装。yt-dlp 缺失或版本过旧——HomeTube 依赖 yt-dlp 解析链接务必与主程序装在同一个虚拟环境中并定期更新。Windows 激活命令写错——请用.venv\Scripts\activateLinux/macOS 的source命令在 Windows 上无效。Python 版本低于 3.11——用python --version检查旧版本会导致依赖安装失败。8501 端口被占用——修改.env中的PORT值后重启即可。 延伸阅读完整安装与 Docker 部署方案docs/installation.md生产环境部署与反向代理docs/deployment.md依赖清单由 uv 生成requirements/requirements.txt【免费下载链接】hometubeHomeTube is a friendly video downloader managing single video URL into organized content structure for automatic home media server experience.项目地址: https://gitcode.com/gh_mirrors/ho/hometube创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考