下载mediapipe

### 下载和安装 MediaPipe 库

#### 确认环境准备
为了顺利安装 MediaPipe，需先确认 Python 和 pip 的安装情况。这一步骤对于任何操作系统都是必要的[^1]。

#### 安装方式的选择
MediaPipe 支持多种平台上的安装，包括 Windows、Linux (Ubuntu) 及特定硬件如树莓派。不同平台上推荐的安装方法可能有所不同：

- **Windows 用户**应特别注意避免直接使用 `pip install mediapipe` 命令来安装该库，因为这种方式可能导致依赖项 opencv-contrib-python 安装失败的问题[^3]。

- 对于 Linux Ubuntu 用户而言，在官方文档中能找到详细的安装指南[^2]。

- 针对树莓派用户，则建议更改 pip 的默认镜像源至清华大学开源软件镜像站以加速下载过程并提高成功率[^4]。

#### 使用 .whl 文件进行安装
如果选择通过 `.whl` 文件的方式来进行 MediaPipe 的安装，那么整个流程与其他 Python 库非常相似。具体来说就是找到适合当前系统架构版本的 `.whl` 文件之后利用 pip 来完成安装工作。

pip install path_to_wheel_file.whl

其中 `path_to_wheel_file.whl` 是指向已下载好的轮文件的具体路径。

#### 更改镜像源快速安装
针对网络条件不佳的情况或是希望加快下载速度的情形下，可以考虑更换成国内较快的 PyPI 镜像服务器，比如清华提供的服务：

pip install mediapipe -i https://pypi.tuna.tsinghua.edu.cn/simple/

此命令会指定从清华大学维护的一个简单索引页面获取包资源，从而提升下载效率。