使用PPU PIP服务

（推荐）1.7.x引入的OS/CUDA Free模式Index URL

1.7.x引入的OS/CUDA Free模式 PPU PIP源的Python Package Index Base URL的命名固定为：

https://art-pub.eng.t-head.cn/artifactory/api/pypi/pypi_index/simple/

1.6.x引入的OS Free模式Index URL

1.6.x引入的OS Free模式 PPU PIP源的Python Package Index Base URL的命名规则为：{os-free-index-prefix}{cuda}{os-free-index-suffix}，其中字段的含义如下：

完整的OS Free Python Package Index Base URL举例如下：

• https://art-pub.eng.t-head.cn/artifactory/api/pypi/cu128_index/simple/

• https://art-pub.eng.t-head.cn/artifactory/api/pypi/cu126_index/simple/

1.5.3及以下版本PPU PIP源Index URL命名规则

1.5.3及以下版本PPU PIP源的Python Package Index Base URL的命名规则为：{index-prefix}_{os}_{cuda}_{index-suffix}，其中字段的含义如下：

完整的Python Package Index Base URL举例如下：

• https://art-pub.eng.t-head.cn/artifactory/api/pypi/ptgai-pypi_ppu_ubuntu_cu126_index/simple/

• https://art-pub.eng.t-head.cn/artifactory/api/pypi/ptgai-pypi_ppu_ubuntu_cu124_index/simple/

PPU PIP软件包安装指导

以flash-attn==2.4.3+ppu1.5.2.ce为例说明PPU PIP软件包安装指令命名规则：

flash-attn==2.4.3+ppu1.5.2.ce软件包的软件版本、发布版本、ce/oe字段等可以省略，因此理论上您有四种方式安装该软件。

pip install flash-attn==2.4.3+ppu1.5.2.ce 
pip install flash-attn==2.4.3+ppu1.5.2     # ce/oe字段缺省：默认安装的是“优化版”的包，如果没有则安装“社区版”的包
## 推荐使用如下两种
pip install flash-attn==2.4.3              # 发布版本缺省：默认安装PIP源上该版本的最新编译的版本
pip install flash-attn                     # 软件版本缺省：默认安装一个最新版本

使用和修改PIP配置文件

“阿里云提供的PIP服务”和“PTG提供的PIP服务”这两种服务的pip.config配置文件的配置不同，请按需使用。

[global]
index-url = https://aiext-pypi.mirrors.aliyuncs.com/pg1-pip/ubuntu_<cuda-version>/simple/
# eg: index-url = https://aiext-pypi.mirrors.aliyuncs.com/pg1-pip/ubuntu_cu126/simple/

[install]
trusted-host = aiext-pypi.mirrors.aliyuncs.com

[global]
index-url = https://art-pub.eng.t-head.cn/artifactory/api/pypi/ptgai-pypi_ppu_ubuntu_<cuda-version>_index/simple/
# eg: index-url = https://art-pub.eng.t-head.cn/artifactory/api/pypi/ptgai-pypi_ppu_ubuntu_cu126_index/simple/

[install]
trusted-host = art-pub.eng.t-head.cn mirrors.cloud.aliyuncs.com

# 在25.08（包括）之后版本AI容器镜像内使用“阿里云提供的PIP服务” (镜像内默认配置，可以不用操作)
## 如果您是从“PTG提供的PIP服务”切换到“阿里云提供的PIP服务”，则需要先移除pip.config软链接 （rm ~/.pip/pip.config）
ln -s ~/.pip/pip.config.aiext-pypi ~/.pip/pip.config

# 在25.08（包括）之后版本AI容器镜像内使用“PTG提供的PIP服务”
ln -s ~/.pip/pip.config.art-pub ~/.pip/pip.config

配置.netrc文件简化手动输入账密问题

在使用“PTG提供的PIP服务”时需要在安装每个PIP软件包时都手动输入PTG PIP账密（提前向对接PDSA获取），使用上很不方便，可考虑使用.netrc自动化身份验证方案来简化这个过程。

# PIP .netrc
cat > ~/.netrc << EOF
machine art-pub.eng.t-head.cn
login <pip-username>
password <pip-passwd>
EOF

由于~/.netrc文件包含了明文的登录用户名和密码，请确保~/.netrc 文件的权限为600（即只有您可以读写该文件），同时在镜像开发场景使用PIP服务之后建议您删除该文件。