Skip to content

Commit e7df9ed

Browse files
committed
makes the repository leaner
1 parent 2f51158 commit e7df9ed

1 file changed

Lines changed: 40 additions & 71 deletions

File tree

README.md

Lines changed: 40 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -1,117 +1,81 @@
1-
# Isaac Lab – SO‑ARM100 / SOARM101 Project
1+
# Reinforcement Learning with the SO-ARM100 / SO-ARM101 in Isaac Lab
22

3-
[![IsaacSim](https://img.shields.io/badge/IsaacSim-4.5.0/5.0.0-green.svg)](https://docs.isaacsim.omniverse.nvidia.com/latest/index.html)
4-
[![IsaacLab](https://img.shields.io/badge/IsaacLab-2.2.0-green.svg)](https://isaac-sim.github.io/IsaacLab/main/index.html)
5-
[![Python](https://img.shields.io/badge/python-3.11-blue.svg)](https://docs.python.org/3/whatsnew/3.11.html)
6-
[![Linux platform](https://img.shields.io/badge/platform-linux--64-orange.svg)](https://releases.ubuntu.com/22.04/)
7-
[![Windows platform](https://img.shields.io/badge/platform-windows--64-orange.svg)](https://www.microsoft.com/en-us/)
8-
[![DOI](https://zenodo.org/badge/968772915.svg)](https://zenodo.org/badge/latestdoi/968772915)
9-
[![License](https://img.shields.io/badge/license-BSD--3-yellow.svg)](https://opensource.org/licenses/BSD-3-Clause)
10-
[![ci-test](https://img.shields.io/github/actions/workflow/status/MuammerBay/isaac_so_arm101/ci-test.yml?branch=main)](https://github.com/MuammerBay/isaac_so_arm101/actions/workflows/ci-test.yml)
3+
[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
4+
[![Isaac Sim](https://img.shields.io/badge/IsaacSim-5.1.0-76B900.svg)](https://docs.isaacsim.omniverse.nvidia.com/latest/index.html)
5+
[![Isaac Lab](https://img.shields.io/badge/IsaacLab-2.3.0-8A2BE2.svg)](https://isaac-sim.github.io/IsaacLab/main/index.html)
6+
[![Python](https://img.shields.io/badge/python-3.11-3776AB.svg)](https://docs.python.org/3/whatsnew/3.11.html)
117

128
This repository implements tasks for the SO‑ARM100 and SO‑ARM101 robots using Isaac Lab. It serves as the foundation for several tutorials in the LycheeAI Hub series [Project: SO‑ARM101 × Isaac Sim × Isaac Lab](https://lycheeai-hub.com/project-so-arm101-x-isaac-sim-x-isaac-lab-tutorial-series).
139

1410
### 📰 News featuring this repository:
1511

16-
- **10 June 2025:** 🎥 LycheeAI Channel Premiere: SO-ARM101 tutorial series announcement! [🔗 Watch on YouTube](https://www.youtube.com/watch?v=2uH7Zn4SAVI)
17-
- **23 April 2025:** 🤖 NVIDIA Omniverse Livestream: Training a Robot from Scratch in Simulation (URDF → OpenUSD). [🔗 Watch on YouTube](https://www.youtube.com/watch?v=_HMk7I-vSBQ)
18-
- **19 April 2025:** 🎥 LycheeAI Tutorial: How to Create External Projects in Isaac Lab. [🔗 Watch on YouTube](https://www.youtube.com/watch?v=i51krqsk8ps)
12+
- **23 April 2025:** NVIDIA Omniverse Livestream: Training a Robot from Scratch in Simulation (URDF → OpenUSD). [Watch on YouTube](https://www.youtube.com/watch?v=_HMk7I-vSBQ)
13+
- **19 April 2025:** LycheeAI Tutorial: How to Create External Projects in Isaac Lab. [Watch on YouTube](https://www.youtube.com/watch?v=i51krqsk8ps)
1914

20-
### 🤖 Don’t have a SO-ARM? → Buy one with a Discount: `LYCHEEAI5` !
15+
## Installation
2116

22-
There are official vendors who sell all the required parts and already assembled kits such as WowRobo who sponsor this project. Use code `LYCHEEAI5` at checkout for a 5% discount on the [SO-ARM101](https://shop.wowrobo.com/?sca_ref=8879221). Now also for [LeKiwi](https://shop.wowrobo.com/products/lekiwi-mobile-robot).
23-
24-
25-
### 🎬 Watch the Lift Task in action
26-
27-
![rl-video-step-0](https://github.com/user-attachments/assets/890e3a9d-5cbd-46a5-9317-37d0f2511684)
28-
29-
## 🛠️ Installation
30-
31-
1. Install Isaac Lab by following the [official installation guide](https://isaac-sim.github.io/IsaacLab/main/source/setup/installation/index.html) (using conda).
32-
2. Clone this repository **outside** the `IsaacLab` directory.
33-
3. Install the package:
34-
35-
```bash
36-
python -m pip install -e source/isaac_so_arm101
37-
```
38-
39-
## 🚀 Quickstart
17+
Install uv.
18+
```bash
19+
curl -LsSf https://astral.sh/uv/install.sh \| sh
20+
```
4021

41-
To list all available environments:
22+
Clone the repository.
4223

4324
```bash
44-
python scripts/list_envs.py
25+
git clone https://github.com/pal-robotics/pal_mjlab.git
26+
cd pal_mjlab
27+
uv sync
4528
```
4629

47-
## 🐞 Debugging Tasks
48-
49-
Two scripts can help verify your setup:
5030

51-
**Zero Agent**
31+
## Quickstart
5232

53-
Sends zero commands to all robots, confirming that the environment loads correctly:
33+
List available environments.
5434

5535
```bash
56-
python scripts/zero_agent.py --task SO-ARM100-Reach-Play-v0
36+
uv run scripts/list_envs.py
5737
```
5838

59-
**Random Agent**
60-
61-
Sends random commands to all robots, confirming proper actuation:
39+
Test with dummy agents.
6240

6341
```bash
64-
python scripts/random_agent.py --task SO-ARM100-Reach-Play-v0
42+
uv run scripts/zero_agent.py --task SO-ARM100-Reach-Play-v0 # send zero actions
43+
uv run scripts/random_agent.py --task SO-ARM100-Reach-Play-v0 # send random actions
6544
```
6645

67-
## 🏋️‍♂️ Training and Playback
46+
## Reaching
6847

69-
You can train a policy for SO‑ARM100 / SO‑ARM101 tasks (for example, the **Reach** task, which is a basic RL-based IK) with the `rsl_rl` and/or `skrl` library:
48+
Train a RL-based IK policy.
7049

7150
```bash
72-
python scripts/rsl_rl/train.py --task SO-ARM100-Reach-v0 --headless
51+
uv run scripts/rsl_rl/train.py --task SO-ARM100-Reach-v0 --headless
7352
```
7453

75-
After training, validate the learned policy:
54+
Evaluate a trained policy.
7655

7756
```bash
78-
python scripts/rsl_rl/play.py --task SO-ARM100-Reach-Play-v0
57+
uv run scripts/rsl_rl/play.py --task SO-ARM100-Reach-Play-v0
7958
```
8059

81-
This ensures that your policy performs as expected in Isaac Lab before attempting real‑world transfer.
82-
83-
## 🧩 Sim2Sim Transfer
84-
85-
_Work in progress._
86-
8760
## 🛠️ Sim2Real Transfer
8861

8962
_Work in progress._
9063

91-
## 🤝 Contributing
92-
93-
We welcome contributions of all kinds!
94-
Please read our [Contributing Guide](CONTRIBUTING.md) to learn how to set up your environment, follow our coding style, and submit pull requests.
95-
96-
## 📄 License
64+
## 🎬 Watch the Lift Task in action
9765

98-
This project is licensed under the BSD 3-Clause License. See the [LICENSE](LICENSE) file for details.
66+
![rl-video-step-0](https://github.com/user-attachments/assets/890e3a9d-5cbd-46a5-9317-37d0f2511684)
9967

10068
## 🙏 Acknowledgements
10169

10270
This project builds upon the excellent work of several open-source projects and communities:
10371

104-
- **[Isaac Lab](https://isaac-sim.github.io/IsaacLab/)** - The foundational robotics simulation framework that powers this project
105-
- **[NVIDIA Isaac Sim](https://developer.nvidia.com/isaac-sim)** - The underlying physics simulation platform
106-
- **[RSL-RL](https://github.com/leggedrobotics/rsl_rl)** - Reinforcement learning library used for training policies
107-
- **[SKRL](https://github.com/Toni-SM/skrl)** - Alternative RL library integration
108-
- **[SO-ARM100/SO-ARM101 Robot](https://github.com/TheRobotStudio/SO-ARM100)** - The hardware platform that inspired this simulation environment
109-
110-
Special thanks to:
72+
- **[Isaac Lab](https://isaac-sim.github.io/IsaacLab/)** — The foundational robotics simulation framework that powers this project
73+
- **[NVIDIA Isaac Sim](https://developer.nvidia.com/isaac-sim)** — The underlying physics simulation platform
74+
- **[RSL-RL](https://github.com/leggedrobotics/rsl_rl)** — Reinforcement learning library used for training policies
75+
- **[SO-ARM100/SO-ARM101 Robot](https://github.com/TheRobotStudio/SO-ARM100)** — The hardware platform that inspired this simulation environment
76+
- **[WowRobo](https://shop.wowrobo.com/?sca_ref=8879221)** — Project sponsor providing assembled SO-ARM kits and parts (use code `LYCHEEAI5` for 5% off)
11177

112-
- The Isaac Lab development team at NVIDIA for providing the simulation framework
113-
- Hugging Face and The Robot Studio for the SO‑ARM robot series
114-
- The LycheeAI Hub community for tutorials and support
78+
Special thanks to the Isaac Lab development team at NVIDIA, Hugging Face and The Robot Studio for the SO‑ARM robot series, and the LycheeAI Hub community for tutorials and support.
11579

11680
## 📚 Citation
11781

@@ -128,3 +92,8 @@ If you use this work, please cite it as:
12892
version = {1.1.0},
12993
year = {2025}
13094
}
95+
```
96+
97+
## License
98+
99+
See [LICENSE](LICENSE) for details.

0 commit comments

Comments
 (0)