Proyecto open source ESP32-CAM

Gizmo Camera

Cámara Wi-Fi con ESP32-CAM que saca una foto JPEG por petición, con una app web para configurarla desde el teléfono y un servidor MCP para agentes de IA.

  • Fotos JPEG de hasta 1600 × 1200
  • API HTTP sencilla
  • Servidor MCP para agentes de IA
Dificultad
Principiante
Tiempo de montaje
15 min
Soldadura
Sin soldadura
La Gizmo Camera en su carcasa impresa blanca y naranja sobre su soporte de rótula, y desmontada en sus piezas: la cubierta, la ESP32-CAM en su placa MB, la tapa trasera, cuatro tornillos M3 y el soporte.

El proyecto de un vistazo

Un resumen rápido del hardware, el firmware y el comportamiento de este montaje.

Cámara

01

El sensor OV2640 y el LED de flash blanco de la ESP32-CAM de AI Thinker, con fotos desde 160 × 120 hasta 1600 × 1200 y calidad JPEG ajustable.

API HTTP

02

Cada foto es una petición GET a /api/capture que devuelve un JPEG, con la resolución, la calidad y el flash como opciones, así que navegadores, scripts y servidores de domótica pueden usarla por igual.

Agentes de IA

03

Un servidor MCP en /mcp permite que agentes como Claude Code miren a través de la cámara con la herramienta take_snapshot, y una guía en Markdown en /llms.txt explica cómo usarlo.

Configuración inicial

04

Flasheo desde el navegador y después configuración desde un hotspot en el primer arranque, con acceso local mediante gizmo-camera.local en las redes compatibles. Sin código que editar y sin credenciales en el firmware.

Descripción general

Gizmo Camera le da un trabajo de verdad a un módulo ESP32-CAM barato: una cámara en tu red que responde a cada petición con una foto recién sacada. Apúntala a una impresora 3D, una planta o una puerta, y cualquier cosa capaz de hacer una petición HTTP verá lo que ella ve. Los agentes de IA la tienen como servidor MCP, así que ellos también pueden mirar a través de ella.

  • Fotos JPEG bajo petición, de hasta 1600 × 1200 con el OV2640, y el LED de flash para escenas oscuras
  • Una aplicación web integrada en el firmware, para configurar la cámara y sacar fotos desde el teléfono
  • Una pequeña API HTTP que scripts y otros dispositivos pueden llamar directamente
  • Un servidor MCP y una guía en Markdown, para que los agentes de IA usen la cámara por su cuenta

Cómo funciona

Cada foto, la pida quien la pida, sigue el mismo camino corto.

PasoQué ocurre
PeticiónLa aplicación web, un script o cualquier cliente HTTP llama a /api/capture con la resolución, la calidad y el flash. Un agente de IA pide lo mismo llamando a take_snapshot en el servidor MCP.
DisparoEl firmware aplica las opciones al sensor, enciende el flash si se pidió y captura un fotograma nuevo.
EnvíoEl JPEG se transmite directamente desde la memoria de la cámara al cliente, con su resolución y la hora de captura en las cabeceras de la respuesta.

La cámara saca una foto a la vez: una petición que llega mientras se está sacando otra recibe una respuesta clara de cámara ocupada, y puede volver a intentarlo un momento después.

Para qué sirve

Gizmo Camera convierte unos pocos euros de hardware en una cámara que personas, scripts y agentes de IA pueden usar de la misma manera. También es una plantilla compacta para cualquier dispositivo ESP32 que deba ser fácil de manejar desde código.

  • Revisa una impresión, una planta o una puerta desde el teléfono, sin app ni cuenta en la nube.
  • Obtén fotos desde scripts y domótica con una sola petición HTTP.
  • Dale a un agente de IA ojos en el mundo físico, en tu propia red.

La aplicación web

Lo que ves en el móvil cuando el dispositivo ya está en tu Wi-Fi.

La pantalla de la cámara en la aplicación web, con la última foto (una imagen de prueba a 1600 × 1200), su tamaño y la hora de captura, y los botones para sacar otra y guardarla.
La pantalla de la cámara antes de la primera foto, con el botón para sacarla y las opciones de resolución y calidad.
La pantalla del Wi-Fi, con la red actual y las redes al alcance.

Qué necesitas

Los componentes que debes conseguir antes de empezar y en qué fijarte al comprarlos.

  • 1×

    ESP32-CAM de AI Thinker

    Con la cámara OV2640 y los 4 MB de PSRAM que necesita el firmware: todos los módulos de AI Thinker tienen ambas.

  • 1×

    Placa USB ESP32-CAM-MB

    El adaptador USB sobre el que se coloca la ESP32-CAM, para flashearla y alimentarla: la ESP32-CAM no tiene puerto USB propio.

  • 1×

    Cable micro-USB de datos

    Un cable de datos, no solo de carga, en un buen puerto USB o una fuente de 5 V: el LED de flash y el Wi-Fi provocan picos de corriente.

Puesta en marcha

Sigue estos pasos para poner el proyecto en marcha, desde la primera configuración local hasta la carga inicial o la configuración.

  1. 01

    Paso 1

    Conecta la ESP32-CAM a su placa MB y a la computadora por USB

    La ESP32-CAM no tiene puerto USB propio: colócala sobre su placa USB ESP32-CAM-MB y conéctala a tu computadora con un cable USB de datos. Usa Chrome o Edge, para que el flasheador del navegador encuentre su puerto serie.

  2. 02

    Paso 2

    Flashea el firmware ya compilado desde esta página

    Baja hasta el bloque de flasheo del firmware, inicia la carga desde el navegador y espera a que termine. Si el flasheador no logra conectar, mantén pulsado IO0 en la placa MB, pulsa y suelta RST, suelta IO0 y vuelve a intentarlo. Al terminar, pulsa RST para arrancar el firmware nuevo.

  3. 03

    Paso 3

    Conecta la cámara a tu Wi-Fi

    En el primer arranque, conéctate con el teléfono al hotspot Gizmo-Camera y elige tu red en la página que se abre. El Wi-Fi se guarda en la placa, nunca en el firmware.

  4. 04

    Paso 4

    Abre gizmo-camera.local y saca una foto

    Cuando la cámara se conecte a tu Wi-Fi, abre gizmo-camera.local, o su dirección IP, elige la resolución, la calidad y el flash, y saca una foto. Guárdala como JPEG o pídela desde un script con una simple petición HTTP.

    Terminal
    curl -o photo.jpg "http://gizmo-camera.local/api/capture?resolution=SVGA"

Preguntas frecuentes

Algunas respuestas prácticas sobre cómo funciona el proyecto, cómo se configura y qué esperar del hardware.

Para todo lo que quieras revisar de vez en cuando: una impresora 3D, una planta, una puerta o un lugar de estacionamiento. Saca una foto nueva cada vez que alguien la pide, desde la aplicación web, un script, un servidor de domótica o un agente de IA.

Código fuente

Ver Gizmo Camera en GitHub

Explora el repositorio para ver el firmware, las notas de hardware y los detalles de implementación de este montaje.

Abrir GitHub
Ilustración del proyecto de OpenGizmo en GitHub
Open source

Ver también

Más montajes open source con ESP32 para tu próximo proyecto.