A Narsil desk bot
The bot has two boards joined by four wires. The belly, an ESP32-P4 with a 4.3-inch touch screen, runs Xiaozhi: it listens, talks with Claude through your own server, and shows your tasks and pull requests. The head, an ESP32-S3 with a 1.3-inch screen inside a prism cube, only draws Narsil’s face, and it gets its state from the belly over UART.
Read the guides in order. Each one explains what the part does, how it works, the decisions behind it and the conversation where they were taken, then the code.
The guides
- 1The bot and its partsThe two boards of the Narsil desk bot, what each one does, the bill of materials, the three-wire UART link between belly and head, and how data flows through it.
- 2The toolchainWhich ESP-IDF version the bot needs and why, building both boards in Espressif's Docker image, and flashing them from Windows, where Docker cannot reach the USB ports.
- 3Xiaozhi in the bellyWhat Xiaozhi is, how it runs on the Waveshare ESP32-P4 board, how the belly is pointed at your own server instead of xiaozhi.me, and what happens on first boot.
- 4Your own serverRunning xinnan-tech's xiaozhi-esp32-server in minimal mode with Docker on your PC, on the local network only: its configuration, its ports, and how the belly finds it.