esp-mosaico/esp-mosaico-claw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
No description
171 commits 2 branches 0 tags 7.7 MiB
  • C 73.3%
  • TypeScript 8.7%
  • Python 7.6%
  • HTML 7.6%
  • CMake 1.5%
  • Other 1.3%
Find a file
Exact
zhouli 3cf3246c9b
Some checks are pending
Build ESP-IDF project / Build esp_mosaico (push) Waiting to run
Details
Merge branch 'feature/standard_idf_packaging' into 'github_master' 
chore(deps): update esp-claw

See merge request intern-projects/esp-mosaico-claw!97
2026-11-12 09:37:35 +00:00
.github/workflows chore: update CI workflow and add firmware packaging scripts 2026-09-03 22:18:28 +08:00
.gitlab feat(board): enable IR and ADC Lua support 2026-09-09 11:44:50 +08:00
boards/esp_mosaico feat(ui): support rounded display and icons 2026-11-12 17:00:36 +08:00
components fix(display): disable screen timeout by default 2026-11-12 17:25:07 +08:00
fatfs_image/system feat(ui): support rounded display and icons 2026-11-12 17:00:36 +08:00
main feat(usb): integrate ESP-Iris transport 2026-11-12 16:27:11 +08:00
third-party feat(ui): support rounded display and icons 2026-11-12 17:00:36 +08:00
tools refactor(build): restore standard IDF flash flow 2026-11-12 16:27:35 +08:00
.gitignore fix(ui): improve sleep and app flows 2026-10-30 16:34:47 +08:00
.gitlab-ci.yml ci: add gitlab ci 2026-09-08 10:55:46 +08:00
.gitmodules feat: integrate Recovery 0.2 and Vibe Mode 2026-10-13 17:18:36 +08:00
CMakeLists.txt chore(release): bump version to 0.7.0 2026-11-12 17:25:07 +08:00
LICENSE chore: create initial repository snapshot 2026-08-28 20:17:21 +08:00
mosaico-ideas.json feat(tools): add Ideas release packaging script 2026-10-23 11:51:14 +08:00
partitions_16MB.csv feat: integrate Recovery 0.2 and Vibe Mode 2026-10-13 17:18:36 +08:00
README.md refactor(build): restore standard IDF flash flow 2026-11-12 16:27:35 +08:00
requirements.txt feat: integrate Recovery 0.2 and Vibe Mode 2026-10-13 17:18:36 +08:00
sdkconfig.defaults refactor(settings): remove update checking 2026-10-22 16:08:02 +08:00

README.md

ESP-MOSAICO-CLAW

ESP-MOSAICO-CLAW takes ESP-MOSAICO beyond connectivity and display, bringing AI agents, natural interaction, and rich peripheral capabilities to the ESP32-S31. Built on ESP-Claw, this repository also contains the source code for the ESP-MOSAICO factory firmware.

Features

  • Integrates the ESP-Claw Agent Runtime with conversations, memory, skills, Lua extensions, and MCP client/server support.
  • Provides a Mosaic UI optimized for the 480 × 480 round touchscreen, with settings, weather, camera, album, and Bluetooth audio applications.
  • Supports Wi-Fi provisioning, web-based configuration, instant messaging, speech recognition, and firmware update checks.
  • Integrates ESP-MOSAICO hardware including audio, camera, IMU, magnetometer, battery management, and external storage.

Quick Start

Install Python 3 and an ESP-IDF 6.x environment with ESP32-S31 support. Then run the following commands from the repository root:

source /path/to/esp-idf/export.sh
python -m pip install -r requirements.txt
git submodule update --init --recursive
idf.py bmgr -c ./boards -b esp_mosaico
idf.py build

Connect the device, then flash the firmware and open the serial monitor:

idf.py -p PORT flash monitor

To package the existing build as an ESP-Iris System Update bundle without changing the normal ESP-IDF flash flow:

python tools/package_irisfw.py

The bundle is written to build/Mosaico-Claw-system-update.irisfw by default.

Repository Layout

boards/                  ESP-MOSAICO board definitions and driver adaptations
components/              UI, system services, and product components
fatfs_image/             Resources embedded in the SYSTEM filesystem
main/                    Application entry point and runtime service wiring
third-party/esp-claw/    ESP-Claw Git submodule
tools/                   Build helpers and CMake utilities