https://github.com/pyladiesams/robotics-with-micropython-jan2026
Make A Robot with MicroPython. You’ll learn the fundamentals of robotics using MicroPython and an ESP32 microcontroller. We’ll guide you through building a simple robot that can light up LEDs and move a handmade part. The workshop covers wiring, coding, and basic motion control principles, which you can later expand to include sensors or APIs.
https://github.com/pyladiesams/robotics-with-micropython-jan2026
micropython micropython-esp32 robotics workshop
Last synced: 3 months ago
JSON representation
Make A Robot with MicroPython. You’ll learn the fundamentals of robotics using MicroPython and an ESP32 microcontroller. We’ll guide you through building a simple robot that can light up LEDs and move a handmade part. The workshop covers wiring, coding, and basic motion control principles, which you can later expand to include sensors or APIs.
- Host: GitHub
- URL: https://github.com/pyladiesams/robotics-with-micropython-jan2026
- Owner: pyladiesams
- License: mit
- Created: 2025-11-26T17:39:54.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-02-04T20:17:40.000Z (6 months ago)
- Last Synced: 2026-02-05T08:29:39.214Z (6 months ago)
- Topics: micropython, micropython-esp32, robotics, workshop
- Language: Python
- Homepage:
- Size: 60.1 MB
- Stars: 8
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ✨ Build your first robot with MicroPython ✨
### Presentation: [{Robotics Mini Course in Micropython @ Monumental}](workshop-slides.pdf)
In this hands-on session, you’ll learn the fundamentals of robotics using MicroPython and an ESP32 microcontroller.
We’ll guide you through building a simple robot that can light up LEDs and move a handmade part. The workshop covers wiring, coding, and basic motion control principles, which you can later expand to include sensors or APIs.
After this tutorial you'll know how to actuate a motor and read sensor data with MicroPython.
Everything you'll need to build your own robot!
## Prerequisites
### Hardware
* ESP32-S3-DevKit development board
* Micro 180° servo motor (SG90 or similar)
* Jumpers to connect the motor
* USB data cable for programming
### Software
* PyLadies Amsterdam uses [uv](https://docs.astral.sh/uv/) for dependency management
* Python 3.10+
* On Windows: USB access must be enabled, some enterprise-managed devices may have restrictions
## Setup
0. *Only remote participants:
Flash MicroPython to your ESP32 dev board:*
1. *Follow the steps* *[here
](https://micropython.org/download/ESP32_GENERIC_S3/)Make sure to use the [.bin firmware file](https://micropython.org/resources/firmware/ESP32_GENERIC_S3-20251209-v1.27.0.bin)*
1. Clone repository and install dependencies
Run the following code:
```bash
git clone git@github.com:pyladiesams/robotics-with-micropython-jan2026.git
cd robotics-with-micropython-jan2026
# create and activate venv, install dependencies
uv sync
source .venv/bin/activate
```
2. Connect the ESP to your laptop and find out at which serial port it is connected:
```bash
# macOS
ls /dev/cu.* | grep usb
# Linux
ls /dev/tty*
# If many devices show up, run the command twice
# once with the ESP connected and once without
# afterwards you might need to set additional permissions to upload
# Windows
# Check "Device Manager" for COM ports
# the port you are
```
## Workshop Steps
### Step 1: LED blink
LED Blink is the "Hello World" of hardware development.
The ESP32 devboard already has an onboard LED we can use. On the devboard it is connected to the ESP32. In order to program it we need to figure out to which PIN of the ESP the LED is connected.
Update the code with the right pin.
`step1_led_blink/main.py`
After uploading press the reset button on the devboard.
If everything is correct you should now see the LED blinking.
```bash
python utils/upload.py step1_led_blink/main.py
```
Feel free to change the blinking behaviour, eg make a nice rainbow pattern or a continuous color change.
### Step 2: Make the motor move
We control a servo motor using PWM signals.
PWM (Pulse Width Modulation) sends a repeating signal at a fixed frequency. Each cycle consists of a HIGH pulse followed by a LOW period. The duty cycle is the percentage of time the signal is HIGH during each cycle. For servos, the pulse width (duration of the HIGH signal) determines the motor's behavior. A HIGH signal corresponds to a 1 and a LOW signal corresponds to a 0.
For 180° position servos as we use in the workshop, the pulse width controls the absolute angle.
For 360° continuous rotation servos, the pulse width controls speed and direction.
#### Connect the motor to the ESP
- **Servo Motor:**
- Black wire → GND (Ground)
- Red wire → 3.3V (Power Supply)
- Yellow/Orange wire → GPIO 15 (Signal Pin)
`step2_motor_move/main.py`
**Upload:**
```bash
python utils/upload.py step2_motor_move/main.py
```
After uploading press the reset button on the devboard.
Now you should see the motor move.
### Step 3: Sensor Integration
A real robot needs to interact with its environment.
You can connect sensors or cameras to the ESP. In this mini tutorial we will use the internal capacity sensor of the ESP, which works as a touchpad.
Connect a jumper wire to one of the pins and make the color change based on the capacitance.
`step3_sensor_integration/main.py`
Upload:
```bash
python utils/upload.py step3_sensor_integration/main.py
```
After uploading press the reset button on the devboard.
Now the color of your LED should change once you touch the PIN.
As a next step make the motor move to the 20° to the left when you touch the pin once and to the right when touching twice.
## Uploading Code
Use the helper script:
```bash
python utils/upload.py /main.py
```
Or use ampy directly:
```bash
ampy --port /dev/cu.usbserial-0001 put step1_led_blink/main.py /main.py
```
## Video record
Re-watch [this YouTube stream](https://www.youtube.com/live/6u5wlQamD9E)
## Credits
This workshop was set up by @pyladiesams and @jquack
## Appendix
### Resources
- [ESP32-S3-DevKitC-1 Datasheet](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/esp32-s3-devkitc-1/user_guide_v1.1.html)
- [SG90 Servo Motor Datasheet](https://www.kjell.com/globalassets/mediaassets/701916_87897_datasheet_en.pdf?ref=4287817A7A)
- [MG90S Servo Motor Datasheet](https://www.electronicoscaldas.com/datasheet/MG90S_Tower-Pro.pdf)
- [ESP32-S3 esptool Documentation](https://docs.espressif.com/projects/esptool/en/latest/esp32s3/)
- [MicroPython ESP32-S3 Docs](https://docs.micropython.org/en/latest/esp32/quickref.html)
### Pre-Commit Hooks
To ensure our code looks beautiful, PyLadies uses pre-commit hooks. You can enable them by running `pre-commit install`. You may have to install `pre-commit` first, using `uv sync`, `uv pip install pre-commit` or `pip install pre-commit`.
Happy Coding :)