Humanoid Talker — Build ManualHumanoid Talker — Manual de Armado

Four electronic modules, a Pi, and a fistful of jumper wires. That's the whole hardware footprint.Cuatro módulos electrónicos, una Pi y un puñado de cables jumper. Esa es toda la huella de hardware.

We start headless — no monitor, no keyboard. Flash Pi OS Lite, drop your WiFi credentials into the imager, plug in power, and the Pi joins your network on its own.Empezamos sin pantalla — sin monitor, sin teclado. Flashea Pi OS Lite, mete tus credenciales WiFi en el Imager, enchufa la corriente y la Pi se une sola a tu red.

1. Download Raspberry Pi ImagerDescarga Raspberry Pi Imager from raspberrypi.com/software and install it on your laptop.desde raspberrypi.com/software e instálalo en tu laptop.
2. Pick the OSElige el SO: Raspberry Pi OS (other) → Raspberry Pi OS Lite (64-bit). "Lite" matters — the desktop version wastes RAM the talker needs."Lite" importa — la versión con escritorio gasta RAM que el talker necesita.
3. Click the gear iconHaz clic en el ícono del engranaje in the imager to open advanced settings and fill in:en el imager para abrir los ajustes avanzados y rellena:
   • Hostname:Hostname: byr-talker
   • SSH: enabled, password authenticationSSH: habilitado, autenticación por contraseña
   • Username:Usuario: byr, password: anything memorablecontraseña: algo que recuerdes
   • WiFi SSID + password (the same network the RobotiMaker app will use)SSID + contraseña de WiFi (la misma red que usará la app RobotiMaker)
   • Locale: your timezone, keyboard layoutLocale: tu zona horaria y disposición de teclado
4. Write the SD cardEscribe la SD (5–10 minutes), then eject it.(5–10 minutos), luego expúlsala.
5. Insert the SD card in the Pi, plug in powerMete la SD en la Pi y enchufa la corriente. First boot takes 60–90 seconds. The green activity LED flickers steadily while the OS expands the partition.. El primer arranque toma 60–90 segundos. El LED verde de actividad parpadea de forma constante mientras el SO expande la partición.
6. Find your Pi on the networkLocaliza tu Pi en la red from your laptop's terminal:desde el terminal de tu laptop:

   ssh [email protected]
   # or, if .local doesn't resolve, find the IP from your router and:o, si .local no resuelve, busca la IP en tu router y:
   ssh [email protected]

The GC9A01 is a 1.28-inch 240 × 240 round LCD that runs over SPI. It shows the robot's face — base, talking, thinking, surprised, sleeping. Eight wires connect it to the Pi.El GC9A01 es un LCD redondo de 1.28 pulgadas y 240 × 240 que funciona por SPI. Muestra la cara del robot — base, hablando, pensando, sorprendido, durmiendo. Ocho cables lo conectan a la Pi.

The INMP441 is a digital MEMS microphone that speaks I2S directly to the Pi — no ADC, no amplifier. Six wires.El INMP441 es un micrófono MEMS digital que habla I2S directamente con la Pi — sin ADC, sin amplificador. Seis cables.

The MAX98357A takes I2S audio from the Pi and drives a small speaker directly. Five wires from the Pi, two from the speaker.El MAX98357A recibe audio I2S de la Pi y ataca directamente un altavoz pequeño. Cinco cables desde la Pi, dos desde el altavoz.

All four modules wired? Time to introduce your robot to the RobotiMaker app. The app documentation walks you through this step by step — this section summarises the path and links straight to the right pages.¿Los cuatro módulos cableados? Hora de presentarle el robot a la app RobotiMaker. La documentación de la app te guía paso a paso — esta sección resume el camino y enlaza directamente a las páginas correspondientes.

From the moment you hit "Set up" in the app, you don't touch the Pi again. The app runs a pipeline of checks and installs — you just watch the progress bar.Desde el momento en que tocas "Configurar" en la app, no vuelves a tocar la Pi. La app ejecuta una pipeline de comprobaciones e instalaciones — tú sólo miras la barra de progreso.

dtparam=i2s=on
dtparam=spi=on
dtoverlay=googlevoicehat-soundcard

Open your robot in the RobotiMaker app and tap the big Talk button. Ask anything. The face turns into the listening animation, then thinking, then the talking animation plays as the response comes out the speaker.Abre tu robot en la app RobotiMaker y toca el gran botón Talk. Pregunta lo que quieras. La cara cambia a la animación de escuchando, luego pensando, y entonces se reproduce la animación de habla mientras la respuesta sale por el altavoz.

[Tap "Talk" in the RobotiMaker app]
   ↓ app tells the bridge to open the mic and stream PCM over WebSocket
[RobotiMaker voice server]  ←  audio chunks
   ↓ Whisper.cpp speech-to-text
[Transcript]  →  LLM (qwen2:0.5b on a Hetzner ARM)
   ↓ tools: timer, weather, joke, etc.
[Response sentences]
   ↓ Piper text-to-speech, streamed back
[Bridge plays audio + animates face]

Round-trip latency on a Pi Zero 2 W is typically 1.5–3 seconds from tap to first audio out, depending on response length. The face plays an "I'm thinking" animation during that gap so the robot doesn't feel dead.La latencia ida-vuelta en una Pi Zero 2 W suele ser de 1.5–3 segundos desde el toque hasta el primer audio, según el largo de la respuesta. La cara reproduce una animación "estoy pensando" en ese hueco para que el robot no parezca apagado.

All the GPIO assignments in one table. If you ever rewire from scratch, this is what you need.Todas las asignaciones GPIO en una tabla. Si alguna vez recableas desde cero, esto es lo que necesitas.

Every wire from every stage, in one picture. Use this to do a final pre-power-on check.Cada cable de cada etapa, en una sola imagen. Úsalo para una revisión final antes de encender.

Things we learned the hard way. Everything here is already baked into the talker firmware — but if you ever poke around the Pi, this is the context.Cosas que aprendimos a la mala. Todo esto ya está integrado en el firmware del talker — pero si alguna vez hurgas dentro de la Pi, este es el contexto.

"audioCaptureDevice": "plughw:0,0",
"audioPlaybackDevice": "plughw:0,0"

The fast lookup table for things that didn't work.La tabla rápida de consulta para lo que no funciona.

Print this or keep it open in a tab while you wire — every pin number, GPIO label, and alt-function (UART, I²C, SPI) at a glance. Imprime esto o mantenlo abierto en una pestaña mientras cableas — cada número de pin, etiqueta GPIO y función alternativa (UART, I²C, SPI) de un vistazo.