# Apollo: agente de voz para dispositivos con backend propio

> Conecta un dispositivo con micrófono y altavoz a un agente de voz en tu cuenta de Cloudflare. El backend coordina turnos, memoria y herramientas; el protocolo documentado sirve para adaptar el dispositivo.

Verificado el 26 oct 2026.

## Qué es

Apollo conecta un agente personal con un dispositivo físico. El cliente de referencia usa ESP32 y el backend se ejecuta en Cloudflare Workers. La documentación describe tanto los turnos de voz como memoria, herramientas, tareas de fondo y el contrato entre servidor y dispositivo.

## Para qué te sirve

- Cuando quieres prototipar un asistente hablado sobre una placa que ya tienes.
- Cuando necesitas adaptar el firmware con un protocolo conocido en lugar de inventar uno nuevo.
- Cuando buscas combinar recordatorios y herramientas externas con una interfaz de voz.

## Cómo funciona

El dispositivo se comunica con el backend, que coordina reconocimiento, razonamiento y síntesis. La arquitectura documenta sesiones por dispositivo mediante Durable Objects, objetos multimedia en R2 y memoria vectorial, además de colas y flujos de trabajo. El firmware se mantiene como submódulo con su propia documentación.

El modo local `MOCK_VOICE=1` omite voz real y recuperación vectorial. Sirve para desarrollar sin consumir créditos de síntesis o embeddings, pero no valida una conversación hablada completa. La guía de despliegue enumera recursos, credenciales y configuración por separado.

## Antes de empezar

El proyecto fija Bun 1.3.13 como gestor de paquetes. Necesitas además, para probar recursos remotos, una cuenta de Cloudflare y autenticación de Wrangler. La guía local pide como mínimo un secreto compartido del dispositivo y acceso a OpenRouter. La voz real requiere además las credenciales indicadas para ElevenLabs. El código es MIT; la infraestructura y los servicios externos tienen costes y condiciones propios.

## Límites y alternativas

Alojarlo en tu cuenta no significa que la voz y los prompts nunca salgan hacia proveedores. El modo de prueba tampoco cubre hardware, red ni calidad de audio. La guía exige Docker al usar las rutas de Sandbox/Containers. Empieza por una sesión local y valida cada enlace antes de publicar firmware o conectar herramientas que puedan actuar sobre tus datos.

## Recursos

- [Repo en GitHub](https://github.com/galfrevn/apollo) - 240 estrellas, licencia MIT.
- [Licencia](https://github.com/galfrevn/apollo/blob/main/LICENSE) - condiciones del código.
- [Manual](https://github.com/galfrevn/apollo/blob/HEAD/documentation/index.md) - arquitectura y protocolo.
- [Configuración local](https://github.com/galfrevn/apollo/blob/HEAD/documentation/operations/setup.md) - requisitos y modo de prueba.

Datos comprobados con GitHub el 26 oct 2026. Último commit en la rama predeterminada: 2026-08-17.