Compare commits

...

6 Commits

Author SHA1 Message Date
Simon Alibert c394699e46
Merge 1e6a7ea334 into 78fd1a1e04 2025-03-28 13:15:34 +08:00
Steven Palma 78fd1a1e04
chore(docs): update docs (#911) 2025-03-27 09:55:06 +01:00
Steven Palma 90533e6b9f
fix(docs): hot-fix updating installation instructions after #883 (#907) 2025-03-26 13:21:40 +01:00
Simon Alibert 1e6a7ea334 Fix version 2024-09-10 19:26:03 +02:00
Simon Alibert 4439d3af69 Try different base image 2024-09-10 19:19:15 +02:00
Simon Alibert 599b58daa0 Remove ffmpeg build dependencies 2024-09-10 19:00:52 +02:00
10 changed files with 20 additions and 43 deletions

View File

@ -98,14 +98,18 @@ conda create -y -n lerobot python=3.10
conda activate lerobot conda activate lerobot
``` ```
Install 🤗 LeRobot: When using `miniconda`, if you don't have `fffmpeg` in your environment:
```bash ```bash
pip install -e . conda install ffmpeg
``` ```
> **NOTE:** Depending on your platform, If you encounter any build errors during this step Install 🤗 LeRobot:
you may need to install `cmake` and `build-essential` for building some of our dependencies. ```bash
On linux: `sudo apt-get install cmake build-essential` pip install --no-binary=av -e .
```
> **NOTE:** If you encounter build errors, you may need to install additional dependencies (`cmake`, `build-essential`, and `ffmpeg libs`). On Linux, run:
`sudo apt-get install cmake build-essential python-dev pkg-config libavformat-dev libavcodec-dev libavdevice-dev libavutil-dev libswscale-dev libswresample-dev libavfilter-dev pkg-config`. For other systems, see: [Compiling PyAV](https://pyav.org/docs/develop/overview/installation.html#bring-your-own-ffmpeg)
For simulations, 🤗 LeRobot comes with gymnasium environments that can be installed as extras: For simulations, 🤗 LeRobot comes with gymnasium environments that can be installed as extras:
- [aloha](https://github.com/huggingface/gym-aloha) - [aloha](https://github.com/huggingface/gym-aloha)
@ -114,7 +118,7 @@ For simulations, 🤗 LeRobot comes with gymnasium environments that can be inst
For instance, to install 🤗 LeRobot with aloha and pusht, use: For instance, to install 🤗 LeRobot with aloha and pusht, use:
```bash ```bash
pip install -e ".[aloha, pusht]" pip install --no-binary=av -e ".[aloha, pusht]"
``` ```
To use [Weights and Biases](https://docs.wandb.ai/quickstart) for experiment tracking, log in with To use [Weights and Biases](https://docs.wandb.ai/quickstart) for experiment tracking, log in with

View File

@ -1,4 +1,4 @@
FROM nvidia/cuda:12.2.2-devel-ubuntu22.04 FROM nvidia/cuda:12.4.1-base-ubuntu22.04
# Configure image # Configure image
ARG PYTHON_VERSION=3.10 ARG PYTHON_VERSION=3.10
@ -17,33 +17,6 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
python${PYTHON_VERSION} python${PYTHON_VERSION}-venv \ python${PYTHON_VERSION} python${PYTHON_VERSION}-venv \
&& apt-get clean && rm -rf /var/lib/apt/lists/* && apt-get clean && rm -rf /var/lib/apt/lists/*
# Install ffmpeg build dependencies. See:
# https://trac.ffmpeg.org/wiki/CompilationGuide/Ubuntu
# TODO(aliberts): create image to build dependencies from source instead
RUN apt-get update && apt-get install -y --no-install-recommends \
autoconf automake yasm \
libass-dev \
libfreetype6-dev \
libgnutls28-dev \
libunistring-dev \
libmp3lame-dev \
libtool \
libvorbis-dev \
meson \
ninja-build \
pkg-config \
texinfo \
yasm \
zlib1g-dev \
nasm \
libx264-dev \
libx265-dev libnuma-dev \
libvpx-dev \
libfdk-aac-dev \
libopus-dev \
libsvtav1-dev libsvtav1enc-dev libsvtav1dec-dev \
libdav1d-dev
# Install gh cli tool # Install gh cli tool
RUN (type -p wget >/dev/null || (apt update && apt-get install wget -y)) \ RUN (type -p wget >/dev/null || (apt update && apt-get install wget -y)) \
&& mkdir -p -m 755 /etc/apt/keyrings \ && mkdir -p -m 755 /etc/apt/keyrings \

View File

@ -59,7 +59,7 @@ git clone https://github.com/huggingface/lerobot.git ~/lerobot
#### 5. Install LeRobot with dependencies for the feetech motors: #### 5. Install LeRobot with dependencies for the feetech motors:
```bash ```bash
cd ~/lerobot && pip install -e ".[feetech]" cd ~/lerobot && pip install --no-binary=av -e ".[feetech]"
``` ```
Great :hugs:! You are now done installing LeRobot and we can begin assembling the SO100 arms :robot:. Great :hugs:! You are now done installing LeRobot and we can begin assembling the SO100 arms :robot:.

View File

@ -69,7 +69,7 @@ git clone https://github.com/huggingface/lerobot.git ~/lerobot
#### 5. Install LeRobot with dependencies for the feetech motors: #### 5. Install LeRobot with dependencies for the feetech motors:
```bash ```bash
cd ~/lerobot && pip install -e ".[feetech]" cd ~/lerobot && pip install --no-binary=av -e ".[feetech]"
``` ```
## C. Install LeRobot on laptop ## C. Install LeRobot on laptop
@ -110,7 +110,7 @@ git clone https://github.com/huggingface/lerobot.git ~/lerobot
#### 5. Install LeRobot with dependencies for the feetech motors: #### 5. Install LeRobot with dependencies for the feetech motors:
```bash ```bash
cd ~/lerobot && pip install -e ".[feetech]" cd ~/lerobot && pip install --no-binary=av -e ".[feetech]"
``` ```
Great :hugs:! You are now done installing LeRobot and we can begin assembling the SO100 arms and Mobile base :robot:. Great :hugs:! You are now done installing LeRobot and we can begin assembling the SO100 arms and Mobile base :robot:.

View File

@ -33,7 +33,7 @@ git clone https://github.com/huggingface/lerobot.git ~/lerobot
5. Install LeRobot with dependencies for the feetech motors: 5. Install LeRobot with dependencies for the feetech motors:
```bash ```bash
cd ~/lerobot && pip install -e ".[feetech]" cd ~/lerobot && pip install --no-binary=av -e ".[feetech]"
``` ```
## Configure the motors ## Configure the motors

View File

@ -18,7 +18,7 @@ training outputs directory. In the latter case, you might want to run examples/3
It requires the installation of the 'gym_pusht' simulation environment. Install it by running: It requires the installation of the 'gym_pusht' simulation environment. Install it by running:
```bash ```bash
pip install -e ".[pusht]"` pip install --no-binary=av -e ".[pusht]"`
``` ```
""" """

View File

@ -33,7 +33,7 @@ First, install the additional dependencies required for robots built with dynami
Using `pip`: Using `pip`:
```bash ```bash
pip install -e ".[dynamixel]" pip install --no-binary=av -e ".[dynamixel]"
``` ```
Using `poetry`: Using `poetry`:

View File

@ -45,7 +45,7 @@ git clone https://github.com/huggingface/lerobot.git ~/lerobot
6. Install LeRobot with stretch dependencies: 6. Install LeRobot with stretch dependencies:
```bash ```bash
cd ~/lerobot && pip install -e ".[stretch]" cd ~/lerobot && pip install --no-binary=av -e ".[stretch]"
``` ```
> **Note:** If you get this message, you can ignore it: `ERROR: pip's dependency resolver does not currently take into account all the packages that are installed.` > **Note:** If you get this message, you can ignore it: `ERROR: pip's dependency resolver does not currently take into account all the packages that are installed.`

View File

@ -32,7 +32,7 @@ git clone https://github.com/huggingface/lerobot.git ~/lerobot
5. Install LeRobot with dependencies for the Aloha motors (dynamixel) and cameras (intelrealsense): 5. Install LeRobot with dependencies for the Aloha motors (dynamixel) and cameras (intelrealsense):
```bash ```bash
cd ~/lerobot && pip install -e ".[dynamixel, intelrealsense]" cd ~/lerobot && pip install --no-binary=av -e ".[dynamixel, intelrealsense]"
``` ```
## Teleoperate ## Teleoperate

View File

@ -24,7 +24,7 @@ Designed by Physical Intelligence. Ported from Jax by Hugging Face.
Install pi0 extra dependencies: Install pi0 extra dependencies:
```bash ```bash
pip install -e ".[pi0]" pip install --no-binary=av -e ".[pi0]"
``` ```
Example of finetuning the pi0 pretrained model (`pi0_base` in `openpi`): Example of finetuning the pi0 pretrained model (`pi0_base` in `openpi`):