Instalación de nitropy con pipx#

Esta guía explica cómo instalar nitropy con pipx. pipx crea un entorno virtual para nitropy. Esto significa que nitropy y sus dependencias no entran en conflicto con otros paquetes instalados en su sistema.

Nota

Para los usuarios de Windows: El soporte de Windows es todavía experimental - por favor, utilícelo con precaución. También puede utilizar binarios precompilados o un instalador MSI, véase Instalación de nitropy en Windows.

Instalación en Linux#

Ubuntu, Debian#

Puede instalar nitropy junto con el resto de dependencias necesarias mediante:

sudo apt install pipx && pipx ensurepath && pipx install pynitrokey

Tras cerrar la sesión o reiniciar el sistema, nitropy estará disponible.

Arch#

Puede instalar nitropy junto con el resto de dependencias necesarias mediante:

sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey

Si ya ha instalado Python en su sistema, sólo tiene que ejecutar:

sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey

Tras cerrar la sesión o reiniciar el sistema, nitropy estará disponible.

Instalación en otras distribuciones/sistemas operativos#

Preparación#

Python 3.9, 3.10 o 3.11#

Python ya está instalado en la mayoría de los sistemas macOS y Linux o puede descargarse desde python.org. Consulte la Guía de descarga de Python para obtener más información.

pip#

Puede instalar pip con el gestor de paquetes de su sistema o con python3 -m ensurepip. Consulte la Guía de instalación de pip para obtener más información.

pipx#

Antes de instalar nitropy, hay que instalar y configurar pipx:

python3 -m pip install --user pipx
python3 -m pipx ensurepath

Consulte la Guía de instalación de pipx para obtener más información.

Nota

Para usuarios de Linux - actualmente una dependencia transitoria (oscrypto) está generando problemas en algunas distribuciones de Linux. El respectivo GitHub tema documenta la solución actualmente necesaria:

pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"

Instalación#

Ahora puedes instalar nitropy desde el paquete pynitrokey:

pipx install pynitrokey

nitropy está ahora disponible en su ruta:

nitropy --help

Actualizar#

Puede actualizar el paquete con el siguiente comando:

pipx upgrade pynitrokey

Solución de problemas#

Si tiene problemas, asegúrese de que utiliza la última versión comparando la salida de nitropy version con la lista de versiones ` en GitHub. Si una actualización no instala la última versión, es posible que te encuentres con uno de los siguientes problemas.

Versión incorrecta de Python#

nitropy requiere Python 3.9 o 3.10. Si su instalación por defecto de Python es más antigua o más reciente que eso y no se puede actualizar, tiene que instalar adicionalmente Python 3.9 y especificar el nombre de su ejecutable Python al llamar a pipx, por ejemplo:

$ pipx install --python python3.9 pynitrokey

Brazo no soportado#

Actualmente, las versiones recientes de nitropy no pueden instalarse en plataformas Arm debido a un problema de dependencia (GitHub issue). Como solución alternativa, puede utilizar una instalación de Python x86 en un terminal Rosetta como se describe en esta discusión).

libusb-1.0.dylib no encontrado#

Al ejecutar nitropy en macOS, es posible que aparezca un mensaje de error indicando que falta el archivo libusb-1.0.dylib. Esto puede solucionarse instalando manualmente libusb, por ejemplo, con homebrew:

$ brew install libusb

Notas de uso#

Todas las plataformas#

Si quieres usar nitropy con un dispositivo Nitrokey Pro o Nitrokey Storage, también tienes que instalar libnitrokey.

Windows#

La compatibilidad con Windows es todavía experimental: utilícela con precaución.

Es posible que tengas que ejecutar nitropy con derechos de administrador para poder conectarte a un dispositivo.

Linux#

En los sistemas Linux, también necesita las reglas udev de Nitrokey. Se suministran con libnitrokey. Alternativamente, puede instalarlos manualmente:

wget https://raw.githubusercontent.com/Nitrokey/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Consulte Configuración de las reglas udev para más información.

Usage of PIV features#

To be able to use the PIV functionality of nitropy (nitropy nk3 piv), you need to install the pyscard dependency too:

pipx install pynitrokey[pcsc]

Próximos pasos#

Puedes encontrar más información sobre el uso de nitropía en estas guías: