mirror of
https://github.com/TheRobotStudio/SO-ARM100.git
synced 2026-01-07 22:43:57 -05:00
Update (#67)
* Add SO101, cleanup repo * align images to middle * align main readme * Update readme * update prices in table * update links * Update README.md Co-authored-by: Remi <re.cadene@gmail.com> * Update links alibaba with new geared motors --------- Co-authored-by: Remi <re.cadene@gmail.com>
This commit is contained in:
Pepijn
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -17,7 +17,7 @@ This guide provides step-by-step instructions for installing a **Wrist Camera**
|
||||
## Required Components
|
||||
### Hardware:
|
||||
- **USB Camera Module** (1) - this is the [recommended model](https://www.amazon.com/innomaker-Computer-Raspberry-Support-Windows/dp/B0CNCSFQC1/ref=pd_lpo_d_sccl_3/132-7372155-9780230?pd_rd_w=eYz4L&content-id=amzn1.sym.4c8c52db-06f8-4e42-8e56-912796f2ea6c&pf_rd_p=4c8c52db-06f8-4e42-8e56-912796f2ea6c&pf_rd_r=XC3EXZRSSXKDB1G0Z5D7&pd_rd_wg=1wTpn&pd_rd_r=932b1976-9ac7-4cef-9774-f0f9c3acb804&pd_rd_i=B0CNCSFQC1&psc=1), but any 32mm x 32mm USB camera module with min 720p / 30 fps spec will likely work
|
||||
- [3D-printed Wrist Roll Replacement](stl/Camera_Holder_Alternate_MF.stl) (1)
|
||||
- [3D-printed Wrist Roll Replacement](Optional/Wrist_Cam_Mount_32x32_UVC_Module/stl/Camera_Holder_Alternate_MF.stl) (1)
|
||||
- **M2 Screws** (4) - these are the smaller screws that came with your Feetech servos.
|
||||
|
||||
|
||||
|
||||
@@ -7,8 +7,8 @@ This guide provides step-by-step instructions for installing a **wrist camera**
|
||||
### Hardware:
|
||||
- [Vinmooog Webcam](https://www.amazon.fr/Vinmooog-equipement-Microphone-Enregistrement-conf%C3%A9rences/dp/B0BG1YJWFN/)
|
||||
- **3D-printed parts:**
|
||||
- `Optional/Camera_Holder/stl/Updated_Wrist_Camera_Insert.stl` (Print **1x**)
|
||||
- `Optional/Camera_Holder/stl/Webcam_Mount_Wrist v2.stl` (Print **1x**)
|
||||
- [Modified wirst](Optional/Wrist_Cam_Mount_Vinmooog_Webcam/stl/Updated_Wrist_Camera_Insert.stl) (Print **1x**), not needed for SO-101
|
||||
- [Mount](Optional/Wrist_Cam_Mount_Vinmooog_Webcam/stl/Webcam_Mount_Wrist.stl) (Print **1x**)
|
||||
- **Fasteners:**
|
||||
- 3x **M3 Nut**
|
||||
- 1x **M3x12mm bolt**
|
||||
|
||||
Binary file not shown.
Binary file not shown.
277
README.md
277
README.md
@@ -1,161 +1,224 @@
|
||||
# SO-ARM100
|
||||
<div align="center">
|
||||
|
||||
Standard Open Arm 100 - Version 1.3
|
||||
<h1>Standard Open SO-100 & SO-101 Arms</h1>
|
||||
<div style="display: flex; gap: 1rem; justify-content: center; align-items: center;" >
|
||||
<img
|
||||
src="media/SO101_Follower.webp?raw=true"
|
||||
alt="SO-101 follower arm"
|
||||
title="SO-101 follower arm"
|
||||
style="width: 40%;"
|
||||
/>
|
||||
<img
|
||||
src="media/SO101_Leader.webp?raw=true"
|
||||
alt="SO-101 leader arm"
|
||||
title="SO-101 leader arm"
|
||||
style="width: 40%;"
|
||||
/>
|
||||
</div>
|
||||
|
||||
|
||||
<h2>
|
||||
<p>Build Your Own SO-101 Robot!</p>
|
||||
</h2>
|
||||
|
||||
Join the project with some of the brightest minds in open AI and robotics development on the [discord server](https://discord.gg/ggrqhPTsMe).
|
||||
The SO‑101 is the next‑generation version of the SO‑100 robot arm, originally designed by the [RobotStudio](https://www.therobotstudio.com) in collaboration with [Hugging Face](https://huggingface.co/lerobot). It has improved wiring, is easier to assembly (no gear removal) and uses updated motors for the leader arm.
|
||||
|
||||
## Sourcing Parts
|
||||
These arms are designed to work seamlessly with the open‑source 🤗 LeRobot library. Join our community on [Discord](https://discord.gg/ggrqhPTsMe) to collaborate on both hardware and software, and help make end‑to‑end AI for robotics more accessible.
|
||||
|
||||
Note: The follower and leader arm for this teleoperation setup will have the same off the shelf parts. If you plan on creating the classic teleoperation set up to be used with the `LeRobot` library please buy from the Parts for Two Arms below. Note prices and items may vary depending on geographic location.
|
||||
</div>
|
||||
|
||||
/!\ Warning: We only have links for US, EU and CN for now. If you find links for other countries, please create an issue or PR so that we add them to the list.
|
||||
### Documentation 📖
|
||||
- For the SO‑101 docs, follow this page further.
|
||||
- Here can you find the [SO‑100 docs](SO100.md) which is depreciated.
|
||||
|
||||
#### Parts For Two Arms (Standard Teleoperation Setup):
|
||||
### Getting Your Own SO‑101
|
||||
You have two options:
|
||||
- **Build it yourself**
|
||||
- Source the components from the [Bill of materials](https://github.com/TheRobotStudio/SO-ARM100#sourcing-parts).
|
||||
- 3D print the parts (or order the 3D printed parts), explained in [Printing the parts](https://github.com/TheRobotStudio/SO-ARM100?tab=readme-ov-file#printing-the-parts).
|
||||
- Follow our [Assembly Guide](https://github.com/huggingface/lerobot/blob/main/examples/12_use_so101.md).
|
||||
- **Buy a kit**
|
||||
- Buy assembled arms or a parts kit from one of the vendors [here](https://github.com/TheRobotStudio/SO-ARM100?tab=readme-ov-file#kits).
|
||||
- Optinally follow our [Assembly Guide](https://github.com/huggingface/lerobot/blob/main/examples/12_use_so101.md).
|
||||
|
||||
| Part | Amount | Unit Cost (US) | Buy US | Unit Cost (EU) | Buy EU | Unit Cost (RMB) | Buy CN |
|
||||
| ------------------------------------------- | ------ | -------------- | --------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------- |
|
||||
| STS3215 Servo<sup>[1](#myfootnote1)</sup> | 12 | $15 | [Alibaba](https://www.alibaba.com/product-detail/6PCS-7-4V-STS3215-Servos-for_1600523509006.html) | 13€ | [Alibaba](https://www.alibaba.com/product-detail/6PCS-7-4V-STS3215-Servos-for_1600523509006.html) | ￥97.72 | [TaoBao](https://item.taobao.com/item.htm?id=712179366565&skuId=5268252241438) |
|
||||
| Motor Control Board | 2 | $11 | [Amazon](https://www.amazon.com/Waveshare-Integrates-Control-Circuit-Supports/dp/B0CTMM4LWK/) | 12€ | [Amazon](https://www.amazon.fr/-/en/dp/B0CJ6TP3TP/) | ￥27 | [TaoBao](https://detail.tmall.com/item.htm?id=738817173460&skuId=5096283384143) |
|
||||
| USB-C Cable 2 pcs | 1 | $7 | [Amazon](https://www.amazon.com/Charging-etguuds-Charger-Braided-Compatible/dp/B0B8NWLLW2/?th=1) | 7€ | [Amazon](https://www.amazon.fr/dp/B07BNF842T/) | ￥23.9\*2 | [TaoBao](https://detail.tmall.com/item.htm?id=44425281296&skuId=5611379016222) |
|
||||
| Power Supply<sup>[2](#myfootnote2)</sup> | 2 | $10 | [Amazon](https://www.amazon.com/Facmogu-Switching-Transformer-Compatible-5-5x2-1mm/dp/B087LY41PV/) | 13€ | [Amazon](https://www.amazon.fr/-/en/dp/B01HRR9GY4/) | ￥22.31 | [TaoBao](https://item.taobao.com/item.htm?id=544824248494&skuId=4974994129990) |
|
||||
| Table Clamp 4pcs | 1 | $9 | [Amazon](https://www.amazon.com/TAODAN-Trigger-Ratchet-Woodworking-Processes/dp/B0DJNXF8WH?rps=1&sr=1-18) | ￥9.2 | [TaoBao](https://detail.tmall.com/item.htm?id=801399113134&skuId=5633627126649) |
|
||||
| Screwdriver Set<sup>[3](#myfootnote3)</sup> | 1 | $6 | [Amazon](https://www.amazon.com/Precision-Phillips-Screwdriver-Electronics-Computer/dp/B0DB227RTH) | 10€ | [Amazon](https://www.amazon.fr/dp/B08ZXVMVYD/) | ￥14.9 | [TaoBao](https://detail.tmall.com/item.htm?id=675684600845&skuId=4856851392176) |
|
||||
| Total | --- | $232 | --- | 244€ | --- | ￥1343.16 | --- |
|
||||
### Setup with LeRobot 🤗
|
||||
After sourcing all parts you can setup your SO-101 with LeRobot [tutorial](https://github.com/huggingface/lerobot/blob/main/examples/10_use_so100.md).
|
||||
|
||||
#### Parts for One Arm:
|
||||
### Optional Hardware
|
||||
|
||||
| Part | Amount | Unit Cost (US) | Buy US | Unit Cost (EU) | Buy EU | Unit Cost (RMB) | Buy CN |
|
||||
| ------------------------------------------- | ------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------- |
|
||||
| STS3215 Servo<sup>[1](#myfootnote1)</sup> | 6 | $14 | [Alibaba](https://www.alibaba.com/product-detail/Top-Seller-Low-Cost-Feetech-STS3215_1600999461525.html?spm=a2747.product_manager.0.0.11be71d2ARQb82) | 13€ | [Alibaba](https://www.alibaba.com/product-detail/Top-Seller-Low-Cost-Feetech-STS3215_1600999461525.html?spm=a2747.product_manager.0.0.11be71d2ARQb82) | ￥97.72 | [TaoBao](https://item.taobao.com/item.htm?id=712179366565&skuId=5268252241438) |
|
||||
| Motor Control Board | 1 | $11 | [Amazon](https://www.amazon.com/Waveshare-Integrates-Control-Circuit-Supports/dp/B0CTMM4LWK/) | 12€ | [Amazon](https://www.amazon.fr/-/en/dp/B0CJ6TP3TP/) | ￥27 | [TaoBao](https://detail.tmall.com/item.htm?id=738817173460&skuId=5096283384143) |
|
||||
| USB-C Cable 2 pcs | 1 | $7 | [Amazon](https://www.amazon.com/Charging-etguuds-Charger-Braided-Compatible/dp/B0B8NWLLW2/?th=1) | 7€ | [Amazon](https://www.amazon.fr/dp/B07BNF842T/) | ￥23.9 | [TaoBao](https://detail.tmall.com/item.htm?id=44425281296&skuId=5611379016222) |
|
||||
| Power Supply<sup>[2](#myfootnote2)</sup> | 1 | $10 | [Amazon](https://www.amazon.com/Facmogu-Switching-Transformer-Compatible-5-5x2-1mm/dp/B087LY41PV/) | 13€ | [Amazon](https://www.amazon.fr/-/en/dp/B01HRR9GY4/) | ￥22.31 | [TaoBao](https://item.taobao.com/item.htm?id=544824248494&skuId=4974994129990) |
|
||||
| Table Clamp 2pcs | 1 | $5 | [Amazon](https://www.amazon.com/Mr-Pen-Carpenter-Clamp-6inch/dp/B092L925J4/) | 8€ | [Amazon](https://www.amazon.fr/-/en/dp/B08HZ1QRBF/) | ￥7.8 | [TaoBao](https://detail.tmall.com/item.htm?id=738636473238&skuId=5505939904942) |
|
||||
| Screwdriver Set<sup>[3](#myfootnote3)</sup> | 1 | $6 | [Amazon](https://www.amazon.com/Precision-Phillips-Screwdriver-Electronics-Computer/dp/B0DB227RTH) | 10€ | [Amazon](https://www.amazon.fr/dp/B08ZXVMVYD/) | ￥14.9 | [TaoBao](https://detail.tmall.com/item.htm?id=675684600845&skuId=4856851392176) |
|
||||
| Total | --- | $123 | --- | 128€ | --- | ￥682.23 | --- |
|
||||
This repository also includes a range of optional hardware designs such as a raised leader base and different camera mounts. Here you can explore the [full list](https://github.com/TheRobotStudio/SO-ARM100?tab=readme-ov-file#optional-hardware).
|
||||
|
||||
---
|
||||
|
||||
## Kits
|
||||
|
||||
You can also find kits for the SO100 arms here:
|
||||
You can find all optional for SO-100/SO-101 kits here:
|
||||
|
||||
- from PartaBot :us: [US](https://partabot.com) (They include **assembled** versions, and also sell LeKiwi and Koch robots!)
|
||||
- from Seeed studio: [International](https://www.seeedstudio.com/SO-ARM100-Low-Cost-AI-Arm-Kit.html) or [China](https://item.taobao.com/item.htm?id=878010637397&skuId=5915703371829&spm=a213gs.v2success.0.0.4cbf4831mkqWLn) (They include **3d printed kits**!)
|
||||
- from WowRobo: [International](https://shop.wowrobo.com/products/so-arm100-diy-kit-assembled-version) or [China](https://item.taobao.com/item.htm?ft=t&id=860171734711) (They include **assembled** versions!)
|
||||
- from PartaBot :us: [US](https://partabot.com) (They include **assembled** versions, and also sell LeKiwi and Koch robots)
|
||||
- from Seeed studio :earth_africa: [International](https://www.seeedstudio.com/SO-ARM100-Low-Cost-AI-Arm-Kit.html) or :cn: [China](https://item.taobao.com/item.htm?id=878010637397&skuId=5915703371829&spm=a213gs.v2success.0.0.4cbf4831mkqWLn) (They include **3d printed kits**)
|
||||
- from WowRobo :earth_africa: [International](https://shop.wowrobo.com/products/so-arm100-diy-kit-assembled-version) or :cn: [China](https://item.taobao.com/item.htm?ft=t&id=860171734711) (They include **assembled** versions)
|
||||
|
||||
Additionally you can find SO100 follower arm kit (without leader arm) on [Phospho](https://robots.phospho.ai). It can be especially useful if you own a VR headset.
|
||||
Additionally you can find SO-100 follower arm kit (without leader arm) on [Phospho](https://robots.phospho.ai). It can be especially useful if you own a VR headset.
|
||||
|
||||
## Sourcing Parts
|
||||
|
||||
The follower and leader arm for this teleoperation setup will almost the same off the shelf parts (except for the motors). If you plan on creating the classic teleoperation set up to be used with the `LeRobot` library please buy from the Parts for Two Arms below.
|
||||
|
||||
We only have links for US, EU and CN for now. If you find links for other countries, please create an issue or PR so that we add them to the list. Note that prices and items may vary depending on geographic location.
|
||||
|
||||
> [!IMPORTANT]
|
||||
> The STS3215 motors for the follower arm comes in two sizes. The 7.4V has a stall torque of 16.5kg.cm at 6V (and likely slightly less for a 5V power supply). The 12V version has a stall torque of 30kg.cm. While we found the 7.4V to be sufficient, if you would like more powerful motors you can buy the 12V version [here](https://www.alibaba.com/product-detail/6PCS-12V-30KG-STS3215-High-Torque_1601216757543.html). Note if you do this, you will also have to buy a 12V 5A+ power supply instead of a 5V one. The leader arm is always 7.4V for the SO101.
|
||||
|
||||
#### Parts For Two Arms (Follower and Leader Setup):
|
||||
|
||||
| Part | Amount | Unit Cost (US) | Buy US | Unit Cost (EU) | Buy EU | Unit Cost (RMB) | Buy CN |
|
||||
| ------------------------------------------- | ------ | -------------- | --------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------- |
|
||||
| STS3215 Servo 7.4V, 1/345 gear | 7 | $33.9 | [Alibaba](https://www.alibaba.com/product-detail/Top-Seller-Low-Cost-Feetech-STS3215_1600999461525.html) | €12.2 | [Alibaba](https://www.alibaba.com/product-detail/Top-Seller-Low-Cost-Feetech-STS3215_1600999461525.html) | ￥97.72 | [TaoBao](https://item.taobao.com/item.htm?id=712179366565&skuId=5268252241438) |
|
||||
| STS3215 Servo 7.4V, 1/191 gear | 2 | $33.9 | [Alibaba](https://www.alibaba.com/product-detail/Feetech-STS3215-SO-ARM101-Servo-7_1601430747897.html?spm=a2747.product_manager.0.0.59a371d2W4e0SR) | €12.2 | [Alibaba](https://www.alibaba.com/product-detail/Feetech-STS3215-SO-ARM101-Servo-7_1601430747897.html?spm=a2747.product_manager.0.0.59a371d2W4e0SR) | ￥97.72 | - |
|
||||
| STS3215 Servo 7.4V, 1/147 gear | 3 | $33.9 | [Alibaba](https://www.alibaba.com/product-detail/Feetech-STS3215-SO-ARM101-Servo-7_1601430760797.html?spm=a2747.product_manager.0.0.167371d25QeX3F) | €12.2 | [Alibaba](https://www.alibaba.com/product-detail/Feetech-STS3215-SO-ARM101-Servo-7_1601430760797.html?spm=a2747.product_manager.0.0.167371d25QeX3F) | ￥97.72 | - |
|
||||
| Motor Control Board | 2 | $10.6 | [Amazon](https://www.amazon.com/Waveshare-Integrates-Control-Circuit-Supports/dp/B0CTMM4LWK/) | €11.4 | [Amazon](https://www.amazon.fr/-/en/dp/B0CJ6TP3TP/) | ￥27 | [TaoBao](https://detail.tmall.com/item.htm?id=738817173460&skuId=5096283384143) |
|
||||
| USB-C Cable 2 pcs | 1 | $7 | [Amazon](https://www.amazon.com/Charging-etguuds-Charger-Braided-Compatible/dp/B0B8NWLLW2/?th=1) | €7 | [Amazon](https://www.amazon.fr/dp/B07BNF842T/) | ￥23.9\*2 | [TaoBao](https://detail.tmall.com/item.htm?id=44425281296&skuId=5611379016222) |
|
||||
| Power Supply | 2 | $10 | [Amazon](https://www.amazon.com/Facmogu-Switching-Transformer-Compatible-5-5x2-1mm/dp/B087LY41PV/) | €15.7 | [Amazon](https://www.amazon.fr/-/en/dp/B01HRR9GY4/) | ￥22.31 | [TaoBao](https://item.taobao.com/item.htm?id=544824248494&skuId=4974994129990) |
|
||||
| Table Clamp 4pcs | 1 | $9 | [Amazon](https://www.amazon.com/TAODAN-Trigger-Ratchet-Woodworking-Processes/dp/B0DJNXF8WH?rps=1&sr=1-18) | €9.7 | [Amazon](https://www.amazon.fr/Connex-COXT865210-Lot-Serre-joints-bricolage/dp/B00NA3T2CQ) | ￥5.2*4 | [TaoBao](https://detail.tmall.com/item.htm?id=801399113134&skuId=5633627126649) |
|
||||
| Screwdriver Set<sup>[1](#myfootnote1)</sup> | 1 | $6 | [Amazon](https://www.amazon.com/Precision-Phillips-Screwdriver-Electronics-Computer/dp/B0DB227RTH) | €9 | [Amazon](https://www.amazon.fr/Vinabo-Magnétique-Electronique-Réparation-Informatique/dp/B0BNQBNFFJ) | ￥14.9 | [TaoBao](https://detail.tmall.com/item.htm?id=675684600845&skuId=4856851392176) |
|
||||
| Total | --- | $470 | --- | €226.3 | --- | ￥1343.16 | --- |
|
||||
|
||||
#### Parts for One Follower Arm:
|
||||
|
||||
| Part | Amount | Unit Cost (US) | Buy US | Unit Cost (EU) | Buy EU | Unit Cost (RMB) | Buy CN |
|
||||
| ------------------------------------------- | ------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------- |
|
||||
| STS3215 Servo 7.4V, 1/345 gear | 6 | $33.9 | [Alibaba](https://www.alibaba.com/product-detail/Top-Seller-Low-Cost-Feetech-STS3215_1600999461525.html?spm=a2747.product_manager.0.0.11be71d2ARQb82) | €12.2 | [Alibaba](https://www.alibaba.com/product-detail/Top-Seller-Low-Cost-Feetech-STS3215_1600999461525.html?spm=a2747.product_manager.0.0.11be71d2ARQb82) | ￥97.72 | [TaoBao](https://item.taobao.com/item.htm?id=712179366565&skuId=5268252241438) |
|
||||
| Motor Control Board | 1 | $10.6 | [Amazon](https://www.amazon.com/Waveshare-Integrates-Control-Circuit-Supports/dp/B0CTMM4LWK/) | €11.4 | [Amazon](https://www.amazon.fr/-/en/dp/B0CJ6TP3TP/) | ￥27 | [TaoBao](https://detail.tmall.com/item.htm?id=738817173460&skuId=5096283384143) |
|
||||
| USB-C Cable 2 pcs | 1 | $7 | [Amazon](https://www.amazon.com/Charging-etguuds-Charger-Braided-Compatible/dp/B0B8NWLLW2/?th=1) | €7 | [Amazon](https://www.amazon.fr/dp/B07BNF842T/) | ￥23.9 | [TaoBao](https://detail.tmall.com/item.htm?id=44425281296&skuId=5611379016222) |
|
||||
| Power Supply | 1 | $10 | [Amazon](https://www.amazon.com/Facmogu-Switching-Transformer-Compatible-5-5x2-1mm/dp/B087LY41PV/) | €15.7 | [Amazon](https://www.amazon.fr/-/en/dp/B01HRR9GY4/) | ￥22.31 | [TaoBao](https://item.taobao.com/item.htm?id=544824248494&skuId=4974994129990) |
|
||||
| Table Clamp 2pcs | 1 | $5 | [Amazon](https://www.amazon.com/Mr-Pen-Carpenter-Clamp-6inch/dp/B092L925J4/) | €8 | [Amazon](https://www.amazon.fr/-/en/dp/B08HZ1QRBF/) | ￥7.8 | [TaoBao](https://detail.tmall.com/item.htm?id=738636473238&skuId=5505939904942) |
|
||||
| Screwdriver Set<sup>[1](#myfootnote1)</sup> | 1 | $6 | [Amazon](https://www.amazon.com/Precision-Phillips-Screwdriver-Electronics-Computer/dp/B0DB227RTH) | €9 | [Amazon](https://www.amazon.fr/Vinabo-Magnétique-Electronique-Réparation-Informatique/dp/B0BNQBNFFJ) | ￥14.9 | [TaoBao](https://detail.tmall.com/item.htm?id=675684600845&skuId=4856851392176) |
|
||||
| Total | --- | $242 | --- | €124.3 | --- | ￥682.23 | --- |
|
||||
|
||||
<a name="myfootnote1">1</a>: You do not need to use this exact screwdriver set, but it is highly recommended to have phillips head screw driver sizes #0 and #1 for easiest screw installation and removal. These are both standard sizes which will likely appear in most small screwdriver sets.
|
||||
|
||||
## Printing the Parts
|
||||
|
||||
A variety of 3D printers are acceptable to print the parts necessary of the follower and leader arm. Follow the steps below to ensure a good print.
|
||||
|
||||
1. Choose a printer: The STL files provided ready to print on many FDM printers. Below are the tested and suggested settings though others may work.
|
||||
1. Material: PLA
|
||||
### Step 1: Choose a printer
|
||||
The STL files provided are ready to print on many FDM printers. Below are the tested and suggested settings though others may work.
|
||||
1. Material: PLA+
|
||||
2. Nozzle Diameter and Precision: 0.4mm nozzle diameter at 0.2mm layer height or 0.6mm nozzle at 0.4mm layer height.
|
||||
3. Infill Density: 13%
|
||||
3. Infill Density: 15%
|
||||
4. Sample Printers: [Prusa MINI+](https://www.prusa3d.com/product/original-prusa-mini-semi-assembled-3d-printer-4/), [UP Plus 2](https://shop.tiertime.com/product/tiertime-up-plus-2-3d-printer/), [Creality Ender 3](https://www.amazon.com/Comgrow-Creality-Ender-Aluminum-220x220x250mm/dp/B07BR3F9N6/), [Bambu Lab A/P/X-series](https://bambulab.com)
|
||||
2. Set up the printer
|
||||
1. Setup and Takedown
|
||||
1. Ensure that the printer is calibrated and the bed level is correctly set using the printer specific instructions.
|
||||
2. Clean the print bed, making sure it is free from dust, or grease. If cleaning the bed using water, or other liquid, dry the bed.
|
||||
3. If your printer recommends it, use a standard glue stick and apply a thin, even layer of glue across the print area of the bed. Avoid clumping or uneven application.
|
||||
4. Load the printer filament using printer specific instructions.
|
||||
5. Ensure the printer settings match the ones suggested above (most printers have multiple settings so choose the ones that most closely match).
|
||||
6. Set for supports everywhere but ignore slopes greater than 45 degrees to the horizontal.
|
||||
7. There should be no supports in the screw holes with horizontal axes.
|
||||
3. Check Printer Accuracy
|
||||
1. In the [Gauges](/stl_files_for_3dprinting/Gauges) folder, there are two types of gauges, one to check the size of print against a standard 4x2 lego block and one against a STS3215 servo.
|
||||
|
||||
### Step 2: Set up the printer
|
||||
1. Ensure that the printer is calibrated and the bed level is correctly set using the printer specific instructions.
|
||||
2. Clean the print bed, making sure it is free from dust, or grease. If cleaning the bed using water, or other liquid, dry the bed.
|
||||
3. If your printer recommends it, use a standard glue stick and apply a thin, even layer of glue across the print area of the bed. Avoid clumping or uneven application.
|
||||
4. Load the printer filament using printer specific instructions.
|
||||
5. Ensure the printer settings match the ones suggested above (most printers have multiple settings so choose the ones that most closely match).
|
||||
6. Set for supports everywhere but ignore slopes greater than 45 degrees to the horizontal.
|
||||
7. There should be no supports in the screw holes with horizontal axes.
|
||||
### Step 3: Check Printer Accuracy
|
||||
1. In the [Gauges](STL/Gauges) folder, there are two types of gauges, one to check the size of print against a standard 4x2 lego block and one against a STS3215 servo.
|
||||
1. If you have a STS3215 servo, print:
|
||||
1. [Gauge Zero](/stl_files_for_3dprinting/Gauges/Gauge_0.STL)
|
||||
2. [Gauge Tight](/stl_files_for_3dprinting/Gauges/Gauge_tight_1.STL)
|
||||
1. [Gauge Zero](STL/Gauges/Gauge_0.STL)
|
||||
2. [Gauge Tight](STL/Gauges/Gauge_tight_1.STL)
|
||||
2. If you have a standard lego block, print:
|
||||
1. [Gauge Zero](/stl_files_for_3dprinting/Gauges/Lego_Size_Test_02_zero.STL)
|
||||
2. [Gauge -0.1](/stl_files_for_3dprinting/Gauges/Lego_Size_Test_02_minuspoint1.STL)
|
||||
1. [Gauge Zero](STL/Gauges/Lego_Size_Test_02_zero.STL)
|
||||
2. [Gauge -0.1](STL/Gauges/Lego_Size_Test_02_minuspoint1.STL)
|
||||
2. Test the gauge 0 against your given object (Lego or Servo). The fit should be similar to this [tutorial](https://youtu.be/dss8E3DG2rA).
|
||||
3. If the fit is appropriate, go onto Step 4, otherwise, change your printer settings and try again or create an issue.
|
||||
4. Print the parts: All the parts for the leader or follower are contained in a single file, correctly orientated for z upwards to minimize supports.
|
||||
|
||||
### Step 4: Print the parts
|
||||
All the parts for the leader or follower are for easy 3D printing already contained in a **single file**, correctly orientated for z upwards to minimize supports.
|
||||
1. For printer bed sizes of 220mmx220mm (such as the Ender), print these files:
|
||||
1. [Follower](/stl_files_for_3dprinting/Follower/Print_Follower_SO_ARM100_08k_Ender.STL)
|
||||
2. [Leader](/stl_files_for_3dprinting/Leader/Print_Leader_SO_ARM100_08k_Ender.STL)
|
||||
- [Follower](STL/SO101/Follower/Ender_Follower_SO101.stl)
|
||||
- [Leader](STL/SO101/Leader/Ender_Leader_SO101.stl)
|
||||
2. For printer bed sizes of 205mm x 250mm (such as the Prusa/Up):
|
||||
1. [Follower](/stl_files_for_3dprinting/Follower/Print_Follower_SO_ARM100_08k_UP_Prusa.STL)
|
||||
2. [Leader](/stl_files_for_3dprinting/Leader/Print_Leader_SO_ARM100_08k_UP_Prusa.STL)
|
||||
3. For Bambu Lab A-series:
|
||||
1. Follower ([Part 1](/stl_files_for_3dprinting/Follower/Print_Follower_SO_ARM100_08k_UP_BambuLabA1Mini_part1.STL)) ([Part 2](/stl_files_for_3dprinting/Follower/Print_Follower_SO_ARM100_08k_UP_BambuLabA1Mini_part2.STL))
|
||||
2. Leader ([Part 1](/stl_files_for_3dprinting/Leader/Print_Leader_SO_ARM100_08k_UP_BambuLabA1Mini_part1.stl)) ([Part 2](/stl_files_for_3dprinting/Leader/Print_Leader_SO_ARM100_08k_UP_BambuLabA1Mini_part2.stl))
|
||||
4. For Bambu Lab P-series & X-series
|
||||
1. [Follower](/stl_files_for_3dprinting/Follower/Print_Follower_Bambu_P1P.3mf)
|
||||
2. [Leader](/stl_files_for_3dprinting/Leader/Print_Leader_Bambu_P1P.3mf)
|
||||
1. [Follower](STL/SO101/Follower/Prusa_Follower_SO101.stl)
|
||||
2. [Leader](STL/SO101/Leader/Prusa_Leader_SO101.stl)
|
||||
|
||||
5. Take Down
|
||||
This table contains all individual files:
|
||||
<details>
|
||||
<summary>Table</summary>
|
||||
|
||||
#### Common Parts
|
||||
|
||||
| Part | Link |
|
||||
|-------------------------------------|------------------------------------------------------------------|
|
||||
| Base_motor_holder_SO101.stl | [Base_motor_holder_SO101.stl](STL/SO101/Individual/Base_motor_holder_SO101.stl) |
|
||||
| Base_SO101.stl | [Base_SO101.stl](STL/SO101/Individual/Base_SO101.stl) |
|
||||
| Motor_holder_SO101_Base.stl | [Motor_holder_SO101_Base.stl](STL/SO101/Individual/Motor_holder_SO101_Base.stl) |
|
||||
| Motor_holder_SO101_Wrist.stl | [Motor_holder_SO101_Wrist.stl](STL/SO101/Individual/Motor_holder_SO101_Wrist.stl) |
|
||||
| Under_arm_SO101.stl | [Under_arm_SO101.stl](STL/SO101/Individual/Under_arm_SO101.stl) |
|
||||
| Upper_arm_SO101.stl | [Upper_arm_SO101.stl](STL/SO101/Individual/Upper_arm_SO101.stl) |
|
||||
| Rotation_Pitch_SO101.stl | [Rotation_Pitch_SO101.stl](STL/SO101/Individual/Rotation_Pitch_SO101.stl) |
|
||||
| Wrist_Roll_Pitch_SO101.stl | [Wrist_Roll_Pitch_SO101.stl](STL/SO101/Individual/Wrist_Roll_Pitch_SO101.stl) |
|
||||
| WaveShare_Mounting_Plate_SO101.stl | [WaveShare_Mounting_Plate_SO101.stl](STL/SO101/Individual/WaveShare_Mounting_Plate_SO101.stl) |
|
||||
|
||||
#### Leader‑Specific Parts
|
||||
|
||||
| Part | Link |
|
||||
|-----------------------|------------------------------------------|
|
||||
| Handle_SO101.stl | [Handle_SO101.stl](STL/SO101/Individual/Handle_SO101.stl) |
|
||||
| Trigger_SO101.stl | [Trigger_SO101.stl](STL/SO101/Individual/Trigger_SO101.stl) |
|
||||
| Wrist_Roll_SO101.stl | [Wrist_Roll_SO101.stl](STL/SO101/Individual/Wrist_Roll_SO101.stl) |
|
||||
|
||||
#### Follower‑Specific Parts
|
||||
|
||||
| Part | Link |
|
||||
|---------------------------------|--------------------------------------------------------------|
|
||||
| Moving_Jaw_SO101.stl | [Moving_Jaw_SO101.stl](STL/SO101/Individual/Moving_Jaw_SO101.stl) |
|
||||
| Wrist_Roll_Follower_SO101.stl | [Wrist_Roll_Follower_SO101.stl](STL/SO101/Individual/Wrist_Roll_Follower_SO101.stl) |
|
||||
</details>
|
||||
|
||||
### Step 5: Remove support
|
||||
1. After the print is done, use a putty knife to scrape the the parts off the print bed.
|
||||
2. Remove any support material from parts.
|
||||
|
||||
### Don't Own a 3D printer?
|
||||
Go here: [Printing services](./3DPRINT.md)
|
||||
|
||||
## Assembly tutorial, data collection and AI training
|
||||
### Optional Hardware 🔧
|
||||
|
||||
Follow the [complete guide of LeRobot](https://github.com/huggingface/lerobot/blob/main/examples/10_use_so100.md).
|
||||
Extend your SO‑100/SO‑101 with these add ons
|
||||
<details>
|
||||
<summary>Add‑ons</summary>
|
||||
|
||||
It points to [our video tutorial](https://www.youtube.com/watch?v=FioA2oeFZ5I&ab_channel=HuggingFace).
|
||||
Note: we removed to auto-calibration at the end in favor of manual calibration which is more robust.
|
||||
#### 1. Mount Helper
|
||||
Print the handy mount jig for easier alignment during assembly.
|
||||
|
||||
## Optional Hardware
|
||||
[→ View README](Optional/Mount_Helper/README.md)
|
||||
|
||||
#### Back Plate Motor Attachment
|
||||
You can [attach the WaveShare servo bus controller to you back plate](Optional/Backplate_ServoBus/WaveShare_Mounting_Plate.stl) (with smaller holes).
|
||||
<img src="media/mount_helper.png" alt="Mount Helper" width="150">
|
||||
|
||||
<img height="150" src="media/backplate_motor_attachment.png" />
|
||||
#### 2. Overhead Camera Mount
|
||||
For bird’s‑eye views in single or bi‑manual setups.
|
||||
|
||||
#### Mount Helper
|
||||
Print this [mount helper](Optional/Mount_Helper/README.md) to make your SO-100 easier to assemble.
|
||||
[→ View README](Optional/Overhead_Cam_Mount/README.md)
|
||||
|
||||
<img height="150" src="media/mount_helper.png" />
|
||||
<img src="https://github.com/user-attachments/assets/a652e133-8672-448d-baa0-bdd494a0a515" alt="Overhead Camera Mount" width="150">
|
||||
|
||||
#### Overhead Camera Mount
|
||||
You can [mount an overhead camera](Optional/Overhead_Cam_Mount/README.md) for one or two (bi-manual) arm setups.
|
||||
#### 3. Raised Leader Base
|
||||
Lift your leader arm for low‑ground tasks.
|
||||
|
||||
<img height="150" src="https://github.com/user-attachments/assets/a652e133-8672-448d-baa0-bdd494a0a515" />
|
||||
[→ Download STL](Optional/Raised_Base/Raised_Base_Extension.stl)
|
||||
|
||||
#### Raised Leader Base
|
||||
You can [raise the base of leader arm](Optional/Raised_Leader_Base_SO100/SO100%20Leader%20Base%20Extension.stl) for easier teleoperation near the ground plane.
|
||||
<img src="media/Raised_Base.jpeg" alt="Raised Leader Base" width="150">
|
||||
|
||||
<img height="150" src="media/raised_leader_base.png" />
|
||||
#### 4. Tactile Sensing (AnySkin)
|
||||
Add touch sensing to your gripper.
|
||||
|
||||
#### Tactile Sensing
|
||||
You can find an AnySkin tactile sensor for the SO-100 at [WOWROBO](https://shop.wowrobo.com/products/enhanced-anyskin-premium-crafted-editionwowskin).
|
||||
[→ Find on WOWROBO](https://shop.wowrobo.com/products/enhanced-anyskin-premium-crafted-editionwowskin)
|
||||
|
||||
<img height="150" src="media/tactile_sensor_anyskin.png" />
|
||||
<img src="media/tactile_sensor_anyskin.png" alt="AnySkin Sensor" width="150">
|
||||
|
||||
#### Wrist Cameras
|
||||
| Webcam (Vinmooog) | 32x32mm UVC Module | 32x32mm UVC Module (Plugin) | RealSense™ D405 |
|
||||
| --- | ---| --- | --- |
|
||||
| <img src="media/cam_mount2.jpg" height="150" > | <img height="150" src="media/UVC_cam_mount.jpeg" /> | <img height="150" src="media/UVC_cam_mount_plugin.jpg" /> | <img src="media/d405_mount.jpg" height="150"/> |
|
||||
|
||||
#### 5. Wrist‑Mount Cameras
|
||||
|
||||
| Webcam (Vinmooog) | 32×32 UVC Module | 32×32 UVC Plug‑on | RealSense D405 |
|
||||
|:---------------------:|:-------------------:|:-------------------:|:-------------------:|
|
||||
| <img src="media/cam_mount2.jpg" height="100"> | <img src="media/UVC_cam_mount.jpeg" height="100"> | <img src="media/UVC_cam_mount_plugin.jpg" height="100"> | <img src="media/d405_mount.jpg" height="100"> |
|
||||
| [Instructions](Optional/Wrist_Cam_Mount_Vinmooog_Webcam) | [Instructions](Optional/Wrist_Cam_Mount_32x32_UVC_Module) | [Instructions](Optional/Wrist_Cam_Plug_Mount_32x32_UVC_Module) | [Instructions](Optional/Wrist_Cam_Mount_RealSense_D405) |
|
||||
|
||||
</details>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Optional Software
|
||||
|
||||
Check out this Handy [URDF viewer](https://gkjohnson.github.io/urdf-loaders/).
|
||||
|
||||
## Debugging motors
|
||||
|
||||
## Debugging motors
|
||||
For debugging, any Windows PC can connect over USB to program the servos and to debug or do tests. To do so download [Feetech Software](https://www.feetechrc.com/software.html). For Ubuntu, you can use [FT_SCServo_Debug_Qt](https://github.com/Kotakku/FT_SCServo_Debug_Qt). Note: This step is not necessary as motors can be configured using the LeRobot Library, but this can be helpful for debugging.
|
||||
|
||||
## Footnotes
|
||||
|
||||
<a name="myfootnote1">1</a>: The STS3215 arm comes in two sizes. The 7.4V has a stall torque of 16.5kg.cm at 6V (and likely slightly less for a 5V power supply). The 12V version has a stall torque of 30kg.cm. While we found the 7.4V to be sufficient, if you would like more powerful motors you can buy the 12V version [here](https://www.alibaba.com/product-detail/6PCS-12V-30KG-STS3215-High-Torque_1601216757543.html). Note if you do this, you will also have to buy a 12V 5A+ power supply instead of a 5V one, but all other components will remain the same.\
|
||||
<a name="myfootnote2">2</a>: You can also use an adjustable laboratory power supply with leads.\
|
||||
<a name="myfootnote3">3</a>: You do not need to use this exact screwdriver set, but it is highly recommended to have phillips head screw driver sizes #0 and #1 for easiest screw installation and removal. These are both standard sizes which will likely appear in most small screwdriver sets.\
|
||||
<a name="myfootnote4">4</a>: You do not need to buy these exact parts, but a glue stick and putty knife are almost always necessary for a good 3D print. The glue prevents parts from sticking to the print bed, and the putty knife helps scrape parts from the print bed. However, feel free to check with your specific printer instructions for if these parts are necessary.
|
||||
|
||||
97
SO100.md
Normal file
97
SO100.md
Normal file
@@ -0,0 +1,97 @@
|
||||
<div align="center">
|
||||
|
||||
<h1>Standard Open SO-100 Arm</h1>
|
||||
<div style="display: flex; gap: 1rem; justify-content: center; align-items: center;" >
|
||||
<img src="media/Leader_And_Follower_SO100.jpg" alt="SO-101 follower arm" title="SO-101 follower arm" style="width: 70%;"/>
|
||||
</div>
|
||||
<br><br>
|
||||
|
||||
The SO-100 arm is the original robot arm designed by the [RobotStudio](https://www.therobotstudio.com) in collaboration with [Hugging Face](https://huggingface.co/lerobot).
|
||||
</div>
|
||||
|
||||
## Sourcing Parts
|
||||
|
||||
The follower and leader arm for this teleoperation setup will almost the same off the shelf parts. If you plan on creating the classic teleoperation set up to be used with the `LeRobot` library please buy from the Parts for Two Arms below.
|
||||
|
||||
We only have links for US, EU and CN for now. If you find links for other countries, please create an issue or PR so that we add them to the list. Note that prices and items may vary depending on geographic location.
|
||||
|
||||
#### Parts For Two Arms (Standard Teleoperation Setup):
|
||||
|
||||
| Part | Amount | Unit Cost (US) | Buy US | Unit Cost (EU) | Buy EU | Unit Cost (RMB) | Buy CN |
|
||||
| ------------------------------------------- | ------ | -------------- | --------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------- |
|
||||
| STS3215 Servo<sup>[1](#myfootnote1)</sup> | 12 | $15 | [Alibaba](https://www.alibaba.com/product-detail/6PCS-7-4V-STS3215-Servos-for_1600523509006.html) | 13€ | [Alibaba](https://www.alibaba.com/product-detail/6PCS-7-4V-STS3215-Servos-for_1600523509006.html) | ￥97.72 | [TaoBao](https://item.taobao.com/item.htm?id=712179366565&skuId=5268252241438) |
|
||||
| Motor Control Board | 2 | $11 | [Amazon](https://www.amazon.com/Waveshare-Integrates-Control-Circuit-Supports/dp/B0CTMM4LWK/) | 12€ | [Amazon](https://www.amazon.fr/-/en/dp/B0CJ6TP3TP/) | ￥27 | [TaoBao](https://detail.tmall.com/item.htm?id=738817173460&skuId=5096283384143) |
|
||||
| USB-C Cable 2 pcs | 1 | $7 | [Amazon](https://www.amazon.com/Charging-etguuds-Charger-Braided-Compatible/dp/B0B8NWLLW2/?th=1) | 7€ | [Amazon](https://www.amazon.fr/dp/B07BNF842T/) | ￥23.9\*2 | [TaoBao](https://detail.tmall.com/item.htm?id=44425281296&skuId=5611379016222) |
|
||||
| Power Supply<sup>[2](#myfootnote2)</sup> | 2 | $10 | [Amazon](https://www.amazon.com/Facmogu-Switching-Transformer-Compatible-5-5x2-1mm/dp/B087LY41PV/) | 13€ | [Amazon](https://www.amazon.fr/-/en/dp/B01HRR9GY4/) | ￥22.31 | [TaoBao](https://item.taobao.com/item.htm?id=544824248494&skuId=4974994129990) |
|
||||
| Table Clamp 4pcs | 1 | $9 | [Amazon](https://www.amazon.com/TAODAN-Trigger-Ratchet-Woodworking-Processes/dp/B0DJNXF8WH?rps=1&sr=1-18) | ￥9.2 | [TaoBao](https://detail.tmall.com/item.htm?id=801399113134&skuId=5633627126649) |
|
||||
| Screwdriver Set<sup>[3](#myfootnote3)</sup> | 1 | $6 | [Amazon](https://www.amazon.com/Precision-Phillips-Screwdriver-Electronics-Computer/dp/B0DB227RTH) | 10€ | [Amazon](https://www.amazon.fr/dp/B08ZXVMVYD/) | ￥14.9 | [TaoBao](https://detail.tmall.com/item.htm?id=675684600845&skuId=4856851392176) |
|
||||
| Total | --- | $232 | --- | 244€ | --- | ￥1343.16 | --- |
|
||||
|
||||
#### Parts for One Arm:
|
||||
|
||||
| Part | Amount | Unit Cost (US) | Buy US | Unit Cost (EU) | Buy EU | Unit Cost (RMB) | Buy CN |
|
||||
| ------------------------------------------- | ------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------- |
|
||||
| STS3215 Servo<sup>[1](#myfootnote1)</sup> | 6 | $14 | [Alibaba](https://www.alibaba.com/product-detail/Top-Seller-Low-Cost-Feetech-STS3215_1600999461525.html?spm=a2747.product_manager.0.0.11be71d2ARQb82) | 13€ | [Alibaba](https://www.alibaba.com/product-detail/Top-Seller-Low-Cost-Feetech-STS3215_1600999461525.html?spm=a2747.product_manager.0.0.11be71d2ARQb82) | ￥97.72 | [TaoBao](https://item.taobao.com/item.htm?id=712179366565&skuId=5268252241438) |
|
||||
| Motor Control Board | 1 | $11 | [Amazon](https://www.amazon.com/Waveshare-Integrates-Control-Circuit-Supports/dp/B0CTMM4LWK/) | 12€ | [Amazon](https://www.amazon.fr/-/en/dp/B0CJ6TP3TP/) | ￥27 | [TaoBao](https://detail.tmall.com/item.htm?id=738817173460&skuId=5096283384143) |
|
||||
| USB-C Cable 2 pcs | 1 | $7 | [Amazon](https://www.amazon.com/Charging-etguuds-Charger-Braided-Compatible/dp/B0B8NWLLW2/?th=1) | 7€ | [Amazon](https://www.amazon.fr/dp/B07BNF842T/) | ￥23.9 | [TaoBao](https://detail.tmall.com/item.htm?id=44425281296&skuId=5611379016222) |
|
||||
| Power Supply<sup>[2](#myfootnote2)</sup> | 1 | $10 | [Amazon](https://www.amazon.com/Facmogu-Switching-Transformer-Compatible-5-5x2-1mm/dp/B087LY41PV/) | 13€ | [Amazon](https://www.amazon.fr/-/en/dp/B01HRR9GY4/) | ￥22.31 | [TaoBao](https://item.taobao.com/item.htm?id=544824248494&skuId=4974994129990) |
|
||||
| Table Clamp 2pcs | 1 | $5 | [Amazon](https://www.amazon.com/Mr-Pen-Carpenter-Clamp-6inch/dp/B092L925J4/) | 8€ | [Amazon](https://www.amazon.fr/-/en/dp/B08HZ1QRBF/) | ￥7.8 | [TaoBao](https://detail.tmall.com/item.htm?id=738636473238&skuId=5505939904942) |
|
||||
| Screwdriver Set<sup>[3](#myfootnote3)</sup> | 1 | $6 | [Amazon](https://www.amazon.com/Precision-Phillips-Screwdriver-Electronics-Computer/dp/B0DB227RTH) | 10€ | [Amazon](https://www.amazon.fr/dp/B08ZXVMVYD/) | ￥14.9 | [TaoBao](https://detail.tmall.com/item.htm?id=675684600845&skuId=4856851392176) |
|
||||
| Total | --- | $123 | --- | 128€ | --- | ￥682.23 | --- |
|
||||
|
||||
## Printing the Parts
|
||||
|
||||
A variety of 3D printers are acceptable to print the parts necessary of the follower and leader arm. Follow the steps below to ensure a good print.
|
||||
|
||||
1. Choose a printer: The STL files provided ready to print on many FDM printers. Below are the tested and suggested settings though others may work.
|
||||
1. Material: PLA
|
||||
2. Nozzle Diameter and Precision: 0.4mm nozzle diameter at 0.2mm layer height or 0.6mm nozzle at 0.4mm layer height.
|
||||
3. Infill Density: 13%
|
||||
4. Sample Printers: [Prusa MINI+](https://www.prusa3d.com/product/original-prusa-mini-semi-assembled-3d-printer-4/), [UP Plus 2](https://shop.tiertime.com/product/tiertime-up-plus-2-3d-printer/), [Creality Ender 3](https://www.amazon.com/Comgrow-Creality-Ender-Aluminum-220x220x250mm/dp/B07BR3F9N6/), [Bambu Lab A/P/X-series](https://bambulab.com)
|
||||
2. Set up the printer
|
||||
1. Setup and Takedown
|
||||
1. Ensure that the printer is calibrated and the bed level is correctly set using the printer specific instructions.
|
||||
2. Clean the print bed, making sure it is free from dust, or grease. If cleaning the bed using water, or other liquid, dry the bed.
|
||||
3. If your printer recommends it, use a standard glue stick and apply a thin, even layer of glue across the print area of the bed. Avoid clumping or uneven application.
|
||||
4. Load the printer filament using printer specific instructions.
|
||||
5. Ensure the printer settings match the ones suggested above (most printers have multiple settings so choose the ones that most closely match).
|
||||
6. Set for supports everywhere but ignore slopes greater than 45 degrees to the horizontal.
|
||||
7. There should be no supports in the screw holes with horizontal axes.
|
||||
3. Check Printer Accuracy
|
||||
1. In the [Gauges](/stl_files_for_3dprinting/Gauges) folder, there are two types of gauges, one to check the size of print against a standard 4x2 lego block and one against a STS3215 servo.
|
||||
1. If you have a STS3215 servo, print:
|
||||
1. [Gauge Zero](/stl_files_for_3dprinting/Gauges/Gauge_0.STL)
|
||||
2. [Gauge Tight](/stl_files_for_3dprinting/Gauges/Gauge_tight_1.STL)
|
||||
2. If you have a standard lego block, print:
|
||||
1. [Gauge Zero](/stl_files_for_3dprinting/Gauges/Lego_Size_Test_02_zero.STL)
|
||||
2. [Gauge -0.1](/stl_files_for_3dprinting/Gauges/Lego_Size_Test_02_minuspoint1.STL)
|
||||
2. Test the gauge 0 against your given object (Lego or Servo). The fit should be similar to this [tutorial](https://youtu.be/dss8E3DG2rA).
|
||||
3. If the fit is appropriate, go onto Step 4, otherwise, change your printer settings and try again or create an issue.
|
||||
4. Print the parts: All the parts for the leader or follower are contained in a single file, correctly orientated for z upwards to minimize supports.
|
||||
|
||||
1. For printer bed sizes of 220mmx220mm (such as the Ender), print these files:
|
||||
1. [Follower](/stl_files_for_3dprinting/Follower/Print_Follower_SO_ARM100_08k_Ender.STL)
|
||||
2. [Leader](/stl_files_for_3dprinting/Leader/Print_Leader_SO_ARM100_08k_Ender.STL)
|
||||
2. For printer bed sizes of 205mm x 250mm (such as the Prusa/Up):
|
||||
1. [Follower](/stl_files_for_3dprinting/Follower/Print_Follower_SO_ARM100_08k_UP_Prusa.STL)
|
||||
2. [Leader](/stl_files_for_3dprinting/Leader/Print_Leader_SO_ARM100_08k_UP_Prusa.STL)
|
||||
3. For Bambu Lab A-series:
|
||||
1. Follower ([Part 1](/stl_files_for_3dprinting/Follower/Print_Follower_SO_ARM100_08k_UP_BambuLabA1Mini_part1.STL)) ([Part 2](/stl_files_for_3dprinting/Follower/Print_Follower_SO_ARM100_08k_UP_BambuLabA1Mini_part2.STL))
|
||||
2. Leader ([Part 1](/stl_files_for_3dprinting/Leader/Print_Leader_SO_ARM100_08k_UP_BambuLabA1Mini_part1.stl)) ([Part 2](/stl_files_for_3dprinting/Leader/Print_Leader_SO_ARM100_08k_UP_BambuLabA1Mini_part2.stl))
|
||||
4. For Bambu Lab P-series & X-series
|
||||
1. [Follower](/stl_files_for_3dprinting/Follower/Print_Follower_Bambu_P1P.3mf)
|
||||
2. [Leader](/stl_files_for_3dprinting/Leader/Print_Leader_Bambu_P1P.3mf)
|
||||
|
||||
5. Take Down
|
||||
1. After the print is done, use a putty knife to scrape the the parts off the print bed.
|
||||
2. Remove any support material from parts.
|
||||
|
||||
### Don't Own a 3D printer?
|
||||
Go here: [Printing services](./3DPRINT.md)
|
||||
|
||||
## Assembly tutorial, data collection and AI training
|
||||
|
||||
Follow the [complete guide of LeRobot](https://github.com/huggingface/lerobot/blob/main/examples/10_use_so100.md).
|
||||
|
||||
It points to [our video tutorial](https://www.youtube.com/watch?v=FioA2oeFZ5I&ab_channel=HuggingFace).
|
||||
Note: we removed to auto-calibration at the end in favor of manual calibration which is more robust.
|
||||
20967
STEP/SO101/Base_SO101.step
Normal file
20967
STEP/SO101/Base_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
5784
STEP/SO101/Base_motor_holder_SO101.step
Normal file
5784
STEP/SO101/Base_motor_holder_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
10097
STEP/SO101/Follower_Specific/Moving_Jaw_SO101.step
Normal file
10097
STEP/SO101/Follower_Specific/Moving_Jaw_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
14095
STEP/SO101/Follower_Specific/Wrist_Roll_Follower_SO101.step
Normal file
14095
STEP/SO101/Follower_Specific/Wrist_Roll_Follower_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
5104
STEP/SO101/Leader_Specific/Handle_SO101.step
Normal file
5104
STEP/SO101/Leader_Specific/Handle_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
4287
STEP/SO101/Leader_Specific/Trigger_SO101.step
Normal file
4287
STEP/SO101/Leader_Specific/Trigger_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
7112
STEP/SO101/Leader_Specific/Wrist_Roll_SO101.step
Normal file
7112
STEP/SO101/Leader_Specific/Wrist_Roll_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
7115
STEP/SO101/Motor_holder_SO101_Base.step
Normal file
7115
STEP/SO101/Motor_holder_SO101_Base.step
Normal file
File diff suppressed because it is too large
Load Diff
6849
STEP/SO101/Motor_holder_SO101_Wrist.step
Normal file
6849
STEP/SO101/Motor_holder_SO101_Wrist.step
Normal file
File diff suppressed because it is too large
Load Diff
7958
STEP/SO101/Rotation_Pitch_SO101.step
Normal file
7958
STEP/SO101/Rotation_Pitch_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
390825
STEP/SO101/SO101 Assembly.step
Normal file
390825
STEP/SO101/SO101 Assembly.step
Normal file
File diff suppressed because it is too large
Load Diff
1212
STEP/SO101/Seeedstudio_Mounting_Plate_SO101.step
Normal file
1212
STEP/SO101/Seeedstudio_Mounting_Plate_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
11520
STEP/SO101/Under_arm_SO101.step
Normal file
11520
STEP/SO101/Under_arm_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
11398
STEP/SO101/Upper_arm_SO101.step
Normal file
11398
STEP/SO101/Upper_arm_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
1211
STEP/SO101/WaveShare_Mounting_Plate_SO101.step
Normal file
1211
STEP/SO101/WaveShare_Mounting_Plate_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
20064
STEP/SO101/Wrist_Roll_Pitch_SO101.step
Normal file
20064
STEP/SO101/Wrist_Roll_Pitch_SO101.step
Normal file
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
676090
STL/SO101/Follower/Ender_Follower_SO101.stl
Normal file
676090
STL/SO101/Follower/Ender_Follower_SO101.stl
Normal file
File diff suppressed because it is too large
Load Diff
BIN
STL/SO101/Follower/Prusa_Follower_SO101.stl
Normal file
BIN
STL/SO101/Follower/Prusa_Follower_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Base_SO101.stl
Normal file
BIN
STL/SO101/Individual/Base_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Base_motor_holder_SO101.stl
Normal file
BIN
STL/SO101/Individual/Base_motor_holder_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Handle_SO101.stl
Normal file
BIN
STL/SO101/Individual/Handle_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Motor_holder_SO101_Base.stl
Normal file
BIN
STL/SO101/Individual/Motor_holder_SO101_Base.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Motor_holder_SO101_Wrist.stl
Normal file
BIN
STL/SO101/Individual/Motor_holder_SO101_Wrist.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Moving_Jaw_SO101.stl
Normal file
BIN
STL/SO101/Individual/Moving_Jaw_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Rotation_Pitch_SO101.stl
Normal file
BIN
STL/SO101/Individual/Rotation_Pitch_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/SO101 Assembly.stl
Normal file
BIN
STL/SO101/Individual/SO101 Assembly.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Seeedstudio_Mounting_Plate_SO101.stl
Normal file
BIN
STL/SO101/Individual/Seeedstudio_Mounting_Plate_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Trigger_SO101.stl
Normal file
BIN
STL/SO101/Individual/Trigger_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Under_arm_SO101.stl
Normal file
BIN
STL/SO101/Individual/Under_arm_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/Upper_arm_SO101.stl
Normal file
BIN
STL/SO101/Individual/Upper_arm_SO101.stl
Normal file
Binary file not shown.
BIN
STL/SO101/Individual/WaveShare_Mounting_Plate_SO101.stl
Normal file
BIN
STL/SO101/Individual/WaveShare_Mounting_Plate_SO101.stl
Normal file
Binary file not shown.
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user