Guía de instalación de Python

This guide is intended for Python teams. Java and C++ teams can skip to Guía de Instalación WPILib.

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 2027 we support Python 3.11/3.12/3.13/3.14, but only 3.14 is available for the Systemcore.

Sistemas operativos y arquitecturas compatibles:

  • Windows 11, 64 bit only. Arm-based Windows 11 is unsupported.

  • Debian 13 “Trixie”, 64 bit only.

  • Ubuntu 26.04, 64 bit only.

  • macOS 15 or higher, both Intel and Arm.

Nota

Linux distributions other than those mentioned above that contain glibc >= 2.41 may work, but are unsupported.

Advertencia

Windows 10 support from Microsoft ended in October 2025. While we will not explicitly block Windows 10 from being used, future releases may inadvertently break compatibility with Windows 10. We will not postpone these changes in order to maintain Windows 10 compatibility, and Windows 10 support may break as a result.

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 2026 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-2025/simple robotpy

Instalación fuente

Alternatively, if you have a C++23 compiler installed, you may be able to use pip to install RobotPy from source.

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 13 (Trixie) with GCC 14.

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

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

Download RobotPy for Systemcore

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

If you already have a RobotPy robot project, you can use that to download the pieces needed to run on the Systemcore. If you don’t have a project, running this command in an empty directory will initialize a new robot project:

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 Systemcore 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:

  • Download Python compiled for Systemcore, if it is not already installed

  • Download Systemcore compatible python packages as specified by your 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

When you deploy your code to the Systemcore, the deploy subcommand will automatically install Python (if needed) and your robot project requirements on the Systemcore as part of the deploy process.