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
Usted debe instalar una versión soportada de Python en un sistema operativo con soporte. Cada año nosotros actualizamos RobotPy a la ultima versión disponible de Python. En 2025 nosotros soportamos Python 3.9/3.10/3.11/3.12/3.13, pero solo 3.13 esta disponible para la 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
En Windows, el paquete Visual Studio 2022 redistributable es requerido para ser instalado
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
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.
Si usted necesita construir con una versión especifica del compilador, usted puede especificarlo usando las variables ambientales CC y CXX:
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
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
Esto creara un archivo robot.py y pyproject.toml. El archivo pyproject.toml debería ser personalizable y detalles sobre los requerimientos necesarios para ejecutar su código de robot, junto con otras cosas.
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.tomlInstale los paquetes especificados por su
pyproject.tomlen 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.