Skip to content

Commit 483d231

Browse files
kevinzakkacopybara-github
authored andcommitted
Copybara import of the project:
-- 17b2330 by Kevin Zakka <[email protected]>: Add Berkeley humanoid. COPYBARA_INTEGRATE_REVIEW=#126 from kevinzakka:berkeley-humanoid 17b2330 PiperOrigin-RevId: 703578032 Change-Id: I1626a76185ca4831d8eec123af4a1cdf659f8589
1 parent 286cfe3 commit 483d231

20 files changed

+337
-0
lines changed

LICENSE

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,39 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
126126
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
127127

128128

129+
================================================================================
130+
License for contents in the directory 'berkeley_humanoid/'
131+
================================================================================
132+
133+
Copyright (c) 2024 Hybrid Robotics
134+
All rights reserved.
135+
136+
Redistribution and use in source and binary forms, with or without
137+
modification, are permitted provided that the following conditions are met:
138+
139+
* Redistributions of source code must retain the above copyright notice, this
140+
list of conditions and the following disclaimer.
141+
142+
* Redistributions in binary form must reproduce the above copyright notice,
143+
this list of conditions and the following disclaimer in the documentation
144+
and/or other materials provided with the distribution.
145+
146+
* Neither the name of the copyright holder nor the names of its
147+
contributors may be used to endorse or promote products derived from
148+
this software without specific prior written permission.
149+
150+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
151+
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
152+
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
153+
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
154+
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
155+
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
156+
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
157+
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
158+
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
159+
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
160+
161+
129162
================================================================================
130163
License for contents in the directory 'bitcraze_crazyflie_2/'
131164
================================================================================

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -227,6 +227,7 @@ Menagerie, see [CONTRIBUTING](CONTRIBUTING.md).
227227

228228
| Name | Maker | DoFs | License | MJX |
229229
|------|-------|---------|---------|-----|
230+
| Berkeley Humanoid | Hybrid Robotics | 12 | [BSD-3-Clause](berkeley_humanoid/LICENSE) |✖️|
230231
| Robotis OP3 | Robotis | 20 | [Apache-2.0](robotis_op3/LICENSE) |✖️|
231232
| Unitree G1 | Unitree Robotics | 37 | [BSD-3-Clause](unitree_g1/LICENSE) |✖️|
232233
| Unitree H1 | Unitree Robotics | 19 | [BSD-3-Clause](unitree_h1/LICENSE) |✖️|

berkeley_humanoid/LICENSE

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
Copyright (c) 2024 Hybrid Robotics
2+
All rights reserved.
3+
4+
Redistribution and use in source and binary forms, with or without
5+
modification, are permitted provided that the following conditions are met:
6+
7+
* Redistributions of source code must retain the above copyright notice, this
8+
list of conditions and the following disclaimer.
9+
10+
* Redistributions in binary form must reproduce the above copyright notice,
11+
this list of conditions and the following disclaimer in the documentation
12+
and/or other materials provided with the distribution.
13+
14+
* Neither the name of the copyright holder nor the names of its
15+
contributors may be used to endorse or promote products derived from
16+
this software without specific prior written permission.
17+
18+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19+
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20+
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21+
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
22+
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23+
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24+
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
25+
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
26+
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27+
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

berkeley_humanoid/README.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Berkeley Humanoid Description (MJCF)
2+
3+
> [!IMPORTANT]
4+
> Requires MuJoCo 2.3.4 or later.
5+
6+
## Overview
7+
8+
This package contains a simplified robot description (MJCF) of the [Berkeley
9+
Humanoid](https://berkeley-humanoid.com/) developed by the [Hybrid Robotics
10+
Lab](https://hybrid-robotics.berkeley.edu/) at UC Berkeley. It is derived from the [publicly available URDF description](https://github.com/HybridRobotics/berkeley_humanoid_description).
11+
12+
<p float="left">
13+
<img src="berkeley_humanoid.png" width="400">
14+
</p>
15+
16+
## URDF → MJCF derivation steps
17+
18+
1. Manually edited the MJCF to extract common properties into the `<default>` section.
19+
2. Added a spotlight and tracking light.
20+
3. Added a site for the IMU.
21+
4. Added a camera for tracking.
22+
5. Extracted joint and actuator properties from the [IsaacLab training code](https://github.com/HybridRobotics/isaac_berkeley_humanoid).
23+
6. Added `scene.xml` which includes the robot, with a textured groundplane, skybox, and haze.
24+
25+
## License
26+
27+
This model is released under a [BSD-3-Clause License](LICENSE).
28+
29+
## Publications
30+
31+
The Berkeley Humanoid is described in the following publication:
32+
33+
```bibtex
34+
@misc{2407.21781,
35+
Author = {Qiayuan Liao and Bike Zhang and Xuanyu Huang and Xiaoyu Huang and Zhongyu Li and Koushil Sreenath},
36+
Title = {Berkeley Humanoid: A Research Platform for Learning-based Control},
37+
Year = {2024},
38+
Eprint = {arXiv:2407.21781},
39+
}
40+
```
1.15 MB
Binary file not shown.
749 KB
Binary file not shown.
2.46 MB
Binary file not shown.
3.95 MB
Binary file not shown.

berkeley_humanoid/assets/ll_hr.stl

2.11 MB
Binary file not shown.
422 KB
Binary file not shown.

0 commit comments

Comments
 (0)