- Python 31.8%
- HTML 24.6%
- CSS 17.2%
- JavaScript 13.3%
- C++ 6.1%
- Other 6.9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Backups skip any directory named tmp, which hid scripts, models and renders kept there. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Q7bU4L6CT4kCNscqby4RBD |
||
| .tern | ||
| camera | ||
| checks | ||
| docs | ||
| docs-html | ||
| firmware | ||
| print/presets | ||
| scripts | ||
| src | ||
| vision | ||
| .gitignore | ||
| flake.lock | ||
| flake.nix | ||
| README.md | ||
Bulwark
Printable quadruped that carries the fire-extinguisher turret on its back. It is a heavier relative of Sesame, rebuilt around 25 kg·cm standard servos so it can walk with the full turret (about 2.9 kg in all).
Each leg has two joints, hip and knee, that swing in the walking direction, with the knees pointing backward like Spot's. The body houses the four hip servos, a 2S LiPo in a tunnel along the floor, and an electronics tray (ESP32-S2 Mini, PCA9685 servo driver, 5 V buck). The mech head carries an OLED face and the camera in an oval eye barrel. Pauldrons over the hips, armoured thighs with a knee guard and a piston, and roller hooves give it a heavy look; a light band round the flanks and the rear, and accent rings at the joints, give it a Tron one. Apart from the servos, every part snaps, presses or slides into place.
A navigation camera beside the OLED in the head's oval eye streams its picture over WiFi; scripts on a laptop detect people in it and steer Bulwark to follow them.
The turret sits on the lid, held at its four tank tabs by snap clips. While it sprays, the turret tells Bulwark over WiFi to stand still.
| Overview | X-ray |
|---|---|
![]() |
![]() |
The models are parametric build123d/cadgen scripts. Print target: Bambu Lab P1S, 0.6 mm nozzle, PLA (dark body, a light accent filament). The ESP32-S2 firmware lives in firmware/.
Documentation
The documentation index links every guide:
- Hardware — printed parts, purchased parts, screws and tools
- Printing — plates, slicer settings and print orientation
- Wiring — power, servo driver, controller, face and lights
- Assembly — step-by-step 3D guide from the tray to the turret
- Glossary — every part and feature by name, in colour
- Calibration and use — servo trims, first steps, web control, the turret API and the camera
- Design notes — kinematics, loads, stability and assumed dimensions
- Development — models, checks, slicing, guide renders, firmware and docs
Repository layout
src/ Part models (one decorated model per script) and the assembly
src/lib/ Parameters, placements (frames), features and purchased-part stand-ins
src/plates/ Print plates (3MF)
src/guide/ Assembly-guide scenes and glossary figures
checks/ Leg collision sweep and statics (CoM, tip-over, joint torque)
scripts/ Build, slice, guide-render, mesh and viewer helpers
print/presets/ OrcaSlicer presets (P1S 0.6, PLA)
firmware/ ESP32-S2 firmware (PlatformIO)
camera/ Navigation camera firmware, XIAO ESP32S3 Sense (PlatformIO)
vision/ Laptop-side vision: stream, person following, preview with keyboard driving
docs/ Documentation source (Markdown); docs/img holds generated images
docs-html/ Compiled HTML (generated by tern)
STEP/, 3MF/, gcode/ Generated outputs (git-ignored)
Quick start
The following commands rebuild every model, check the legs and the statics, slice the plates and render the guide images:
scripts/build.sh
(source scripts/env.sh && "${CADGEN[@]}" python checks/interference.py)
(source scripts/env.sh && "${CADGEN[@]}" python checks/stability.py)
scripts/slice.sh
scripts/guide.sh
The firmware builds and flashes with PlatformIO:
nix develop path:. --command pio run -d firmware -t upload
nix develop path:. --command pio run -d camera -t upload
The vision scripts run on a laptop joined to Bulwark's access point; this one follows the nearest person:
nix develop path:.#vision --command python vision/follow.py
scripts/view.sh starts cadgen's CAD viewer and prints links to the guide scenes, the plates and the assembly, where the eight joint sliders pose the legs (hip_fl … knee_rr, offsets from the standing pose).
Documentation build
The documentation (this README and docs/) compiles to docs-html/ with:
nix develop path:. --command tern
Attribution
- Inspired by Sesame by Dorian Todd (Apache-2.0): the idea of an expressive ESP32 quadruped with an OLED face and a web controller. The mechanics, electronics and firmware here are new.
- The turret on top is its own project: https://git.yhkze.net/yuuhikaze/fire-extinguisher-turret.

