在 Windows 中安装 Pynini 的记录

#工作记录

概述

Pynini 是一个用于加权有限状态文法编译的 Python 库，广泛应用于自然语言处理（NLP）领域。以下记录旨在用于回顾和帮助大家在 Windows 系统中安装 Pynini。

安装思路：

优先用conda虚拟环境 或 在python3.12的virtualenv虚拟环境中用.whl文件从本地安装。

安装方法

方法 1：使用 Conda 安装

我们可以通过 Conda 包管理器安装 Pynini。

要在conda虚拟环境安装此软件包，请运行以下命令之一：

conda install conda-forge::pynini

conda install -c conda-forge pynini

conda install conda-forge/label/cf202003::pynini

如果需要特定版本的 Pynini，可以尝试： 

conda install -c conda-forge pynini==2.1.5

conda install -c conda-forge pynini==2.1.6

conda install pynini==2.1.6

conda install -y -c conda-forge pynini==2.1.5

 如果要安装到指定的虚拟环境中：

conda install -c conda-forge pynini==2.1.6 --prefix <虚拟环境目录地址>

参考资料

Pynini | Anaconda.org

 

方法 2：使用 pip 安装

安装前建议先升级一下包管理工具和构建工具

python -m pip install --upgrade pip setuptools wheel

2.1、命令直装（不推荐）

用pip命令安装pynini：

以下命令在Windows下不一定成功，只是提供了一种安装思路，期待将来pynini更新后命令可用。

要安装此软件包，请运行以下命令之一（仅供参考，不保证成功）：

#安装 Pynini 而不安装其依赖项

pip install pynini --no-deps

#如果默认的 PyPI 源速度较慢或不可用，您可以使用阿里云的镜像源：

pip install pynini --no-deps -i https://mirrors.aliyun.com/pypi/simple/  

#如果希望仅安装 Pynini 的二进制文件，可以使用以下命令：

pip install --only-binary :all: pynini

或者：

pip install pynini --prefer-binary

如果希望先下载 Pynini 的源代码包，然后再进行安装，可以使用以下命令：

pip download pynini
pip install 路径\pynini-2.1.6.post1.tar.gz

 2.2、whl文件安装

目前 Pynini 的 Windows 预编译 .whl 文件仅支持 Python 3.12。

我们需要确保虚拟环境中是Python 3.12 版本。

Pynini 的 Windows 预编译 .whl 文件下载地址：

发布 ·SystemPanic/pynini-windows

如果已经下载了 Pynini 的 .whl 文件，可以使用 pip 从本地文件安装。

请确保下载的 .whl 文件与 Python 版本和系统架构相匹配。

打开命令行工具（如 CMD 或 PowerShell），并激活虚拟环境（如果使用的话）。

然后使用以下命令安装 Pynini：

2.2.1、从本地安装

#pip install 带后缀的完整文件名
pip install pynini-2.1.6.post1-cp312-cp312-win_amd64.whl

2.2.1、从下载储存目录安装

将 pynini-2.1.6.post1-cp312-cp312-win_amd64.whl 替换为下载的 .whl 文件的实际路径。

例如，如果文件位于 E:\Downloads 目录下，则命令将是：

#pip install whl文件的完整文件地址
pip install "E:\Downloads\pynini-2.1.6.post1-cp312-cp312-win_amd64.whl"

方法 3：使用 WSL 安装（针对高级用户）

虽然 Pynini 未针对 Windows 设计或测试，但可以通过 Windows Subsystem for Linux (WSL) 进行安装。

只需进入 WSL 环境并遵循 Linux 的安装指南。

pip install pynini

 

验证安装

安装完成后，可以通过以下命令验证 Pynini 是否正确安装：

import pynini
print(pynini.__version__)

如果安装成功，该命令将输出 Pynini 的版本号，而不会引发错误。

常见问题

• 版本不匹配：确保下载的 .whl 文件与 Python 版本和系统架构相匹配。

• 权限问题：在某些情况下，可能需要以管理员权限运行命令行工具来安装 Pynini。

结论

通过上述步骤，我们应该能够在 Windows 系统中成功安装 Pynini。如果在安装过程中遇到任何问题，可以参考 Pynini 的官方文档或搜索相关的错误信息以获取解决方案。