sesame-robot README

The project's README from github.com/dorianborian/sesame-robot. As one markdown file: README.md.

The Sesame Robot Project


License Microcontroller Firmware IDE GitHub stars GitHub forks

sesame-cover

tutorial-button discord-button


Greetings, from your new best friend.

Sesame is an accessible Open-Source robotics project based on the ESP32 microcontroller system, with an emphasis on expression and movement. This project is designed for makers and engineers of all skill levels! Sesame offers a dynamic platform designed to start working with walking robots. To build a sesame robot, you will need basic soldering skills, $50-60 in hardware components, access to a 3D printer, and a basic understanding of Arduino IDE.

This repository contains the CAD design files, STL files, build and wiring guides, and the base/expanded firmware for the ESP32-based controller. There is also some included debugging firmware that may be helpful in getting your Sesame up and running.

Features

Watch the launch video on YouTube

thumb-youtube


Getting Started

Follow these steps to build your own Sesame Robot:

1. Gather Parts

Check the Bill of Materials (BOM) for a complete list of required electronics and hardware.

2. Print Parts

Download the STLs and follow the Printing Guide.

3. Build & Wire

Follow the Build Guide and Wiring Guide to assemble the frame and connect the electronics.

4. Flash Firmware

Upload the code from the Firmware Directory.

5. Create Animations

Use Sesame Studio to visually design poses and sequences for your robot.

sesame-wakeup-gif

Software & Firmware

Sesame Studio

Sesame Studio is a standalone desktop application included in software/sesame-studio/. It allows you to:

> Go to Sesame Studio

Sesame Simulator

The Sesame Simulator, created by Jay Li, is a Rust-based 3D simulation environment for testing Sesame's movements and kinematics in a virtual space. It features:

> Go to Sesame Simulator

Sesame Companion App

The Sesame Companion App is a Python-based application that enables advanced control and interaction with your robot over your local network. It leverages the new JSON API and network mode features to provide:

The Companion App works with robots running the latest firmware with network mode enabled.

> Go to Sesame Companion App Repository

Firmware

The ESP32 firmware (sesame-firmware-main.ino) handles the kinematics, face display, and WiFi control interface.

> Go to Firmware Docs


Contributing

This robot is a platform for building new features, cosmetics, tools, and ideas. Since the current firmware is a basic implementation, pull requests are very welcome for:

I would also love to see forks of this project with new hardware, software, faces, etc. Be sure to send me a message if you end up building one, and I might feature you on my website or channel!


Created by Dorian Todd. Need help with your Sesame Robot? Send me a message on Discord, my username is "starphee"

sesame-robot (dorianborian/sesame-robot)

Searching Database…

What is this?Sesame is an open-source DIY quadruped walking robot built around an ESP32 microcontroller, designed with an emphasis on expressive movement and a reactive face display.
How do I get my own Sesame running?Gather the parts from the BOM, 3D print the STL files, assemble and wire the frame per the guides, then flash the firmware using Arduino IDE and configure WiFi AP settings.
What hardware and skills do I need before starting?You need basic soldering skills, about $50-60 in components, a 3D printer, and basic Arduino IDE knowledge; the build uses an ESP32-based board (e.g. Lolin S2 Mini) and 8x MG90 servos.
Is the firmware feature-complete or still basic?The firmware is described as a basic implementation, and the project actively invites contributions for kinematics, animations, and sensor integration improvements.
Who is this project aimed at?It targets makers and engineers of all skill levels who want an accessible entry point into building walking robots.
How do I control the robot once it is built?Over WiFi via a RESTful JSON API, a built-in web UI accessible from your phone through the robot's Access Point, or a Serial Command Line Interface.
What is Sesame Studio?A standalone desktop app included in the repo for visually posing the robot and sequencing animations, which auto-generates C++ servo-angle code.
Can I add voice control to Sesame?Yes, the separate Python-based Sesame Companion App adds voice assistant integration and remote control over your local network using the robot's JSON API.
Is there a way to test movements without building the hardware?Yes, the Sesame Simulator is a Rust-based, web-accessible 3D physics simulation using URDF models to test walking and balance virtually.
Size
227 MB
Stars
4.7K
Updated
CommitOct 15
Age
10mo
Commits · 90 Days