Guía de instalación de Python

La intención de esta guía es para equipos de python. Equipos de Java y C++ puede saltarse a Guía de Instalación WPILib. Equipos de LabVIEW pueden saltarse a Instalación LabVIEW para FRC (únicamente LabVIEW).

Requisitos previos

You must install a supported version of Python on a supported operating system. Every year we upgrade RobotPy to the latest available version of Python. In 2026 we support Python 3.10/3.11/3.12/3.13/3.14, but only 3.14 is available for the roboRIO.

Sistemas operativos y arquitecturas compatibles:

  • Windows 10 y 11, solo de 64 bits. No son compatibles 32 bits y Arm.

  • macOS 13.3 o más alto

  • Ubuntu 22.04 y 24.04, 64 bit. Otras distribuciones de Linux con glibc >= 2.35 podrían funcionar pero no cuentan con soporte

En Windows y macOS, nosotros recomendamos utilizar los instaladores de Python oficiales distribuidos por python.org.

Instalar RobotPy

Una vez que usted tenga instalado Python, usted puede usar pip para instalar RobotPy en su computadora de desarrollo.

Nota

Si usted tiene previamente instalada una pre-2024 o una versión 2024 beta de RobotPy, debería primero desinstalar RobotPy mediante py -m pip uninstall robotpy antes de actualizar.

Advertencia

On Windows, the Visual Studio 2022 redistributable package is required to be installed.

Corra el siguiente comando desde la cmd o Powershell para instalar los paquetes importantes de RobotPy:

py -3 -m pip install robotpy

Para actualizar, puede correr esto:

py -3 -m pip install --upgrade robotpy

Si no tiene derechos de administrador en su computadora, utilice virtualenv/virtualenvwrapper-win, o usted puede instalar al directorio de usuario site-packages:

py -3 -m pip install --user robotpy

Nota

Si usted tiene previamente instalada una pre-2024 o una versión 2024 beta de RobotPy, debería primero desinstalar RobotPy mediante python3 -m pip uninstall robotpy antes de actualizar

En un sistema de macOS que tenga pip instalado, solo corra el siguiente comando desde la aplicación de la terminal(podría requerir derechos de administrador):

python3 -m pip install robotpy

Para actualizar, puede correr esto:

python3 -m pip install --upgrade robotpy

Si usted no tiene derechos de administración en su computadora, utilice virtualenv/virtualenvwrapper, o puede instalar al directorio de usuario site-packages:

python3 -m pip install --user robotpy

Nota

Si usted tiene previamente instalada una pre-2024 o una versión 2024 beta de RobotPy, debería primero desinstalar RobotPy mediante python3 -m pip uninstall robotpy antes de actualizar

RobotPy distribuye ruedas binarias manylinux en PyPi. Pero, instalar estas requieren una distribucion que tenga glibc 2.35 o nuevo, y un instalador que implementa PEP 600,  como pip 20.3 o más nuevo. Usted puede checar su versión de pip con el siguiente comando:

python3 -m pip --version

Si usted necesita actualizar su versión de pip, es muy recomendable que utilice un ambiente virtual.

Si usted tiene una versión compatible de pip, puede simplemente correr:

python3 -m pip install robotpy

Para actualizar, puede correr esto:

python3 -m pip install --upgrade robotpy

Si usted logra instalar los paquetes y obtener el siguiente error o algo similar, su sistema probablemente no es compatible con RobotPy:

OSError: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.22' not found (required by /usr/local/lib/python3.7/dist-packages/wpiutil/lib/libwpiutil.so)

Nosotros publicamos llantas pre hechas en artefactorio, que pueden ser descargadas al dar la opción --extra-index-url a pip:

python3 -m pip install --extra-index-url=https://wpilib.jfrog.io/artifactory/api/pypi/wpilib-python-release-2026/simple robotpy

Instalación fuente

Alternativamente, si usted tiene un compilador C++20 instalado, usted podría poder usar pip para instalar RobotPy desde la fuente.

Advertencia

¡Podría durar un tiempo muy largo para instalar!

Advertencia

Mesclando nuestras llantas pre hechas con instalaciones de raíz pueden causar errores de runtime. Esto se debe a la incompatibilidad interna ABI entre versiones de compilador.

Our ARM wheels are built for Debian 12 (Bookworm) with GCC 12.

If you need to build with a specific compiler version, you can specify them using the CC and CXX environment variables:

export CC=gcc-12 CXX=g++-12

Descargar RobotPy para la roboRIO

Después de instalar el proyecto robotpy  en su computadora, existen una variedad de comandos disponibles que pueden ejecutarse desde la linea comando mediante el modulo robotpy .

Ver también

Documentación para los subcomandos de robotpy

Si usted ya tiene un proyecto de robot de RobotPy, usted puede usar eso para descargar las piezas necesitadas para correr en la roboRIO. Si usted no tiene un proyecto, ejecutar este comando en un directorio vacío inicializará un nuevo proyecto de robot:

py -3 -m robotpy init

python3 -m robotpy init

python3 -m robotpy init

This will create a robot.py and pyproject.toml file. The robot.py file contains a skeleton structure to help you get started writing your robot code. The pyproject.toml file should be customized and details the requirements needed to run your robot code, among other things.

Importante

The robotpy deploy command requires that you have written working robot code. The generated robot.py is just a starting point - you cannot deploy to the roboRIO until you have implemented your robot-specific code. See the RobotPy Programming Guide for information on writing robot code.

Ver también

El pyproject.toml default creado para usted solo contiene la versión de RobotPy instalada en su computadora. Si quiere habilitar paquetes de vendedores o instalar otros paquetes de python de PyPi, vea nuestra pyproject.toml documentación

Después ejecute el subcomando robotpy sync, el cual:

  • Descargue Python compilado para la roboRIO

  • Descargué los paquetes python compatibles especificados por su pyproject.toml

  • Instale los paquetes especificados por su pyproject.toml en su ambiente local

Nota

Si usted no esta usando un ambiente virtual y no tiene privilegios de administrador, el comando robotpy sync acepta un argumento --user para instalar al directorio user-specific site-packages.

py -3 -m robotpy sync

python3 -m robotpy sync

python3 -m robotpy sync

Cuando suba su código a la roboRIO, el subcomando subido va a instalar automáticamente Python (si es necesario) y los requerimientos del proyecto del robot en la roboRIO como parte de proceso de subir código.