Tu huerto hidropónico, en tu bolsillo. SmartPot mide la temperatura, la humedad, la luz, el pH, los nutrientes y la humedad del sustrato de tus cultivos, te dice qué necesitan y, si quieres, se encarga de regarlos, iluminarlos y ventilarlos.
smartpot.app · Documentación · Diagramas generales · Probar la demo
- Tu cultivo, en maceta, tubos NFT, torre vertical o balsa flotante, envía sus lecturas por MQTT cifrado cada pocos segundos. Al crearlo eliges, de una vez, si es real (un ESP32 con MicroPython, físico o simulado en Wokwi, con su guía de conexión) o virtual: SmartPot lo simula siguiendo el clima real de tu ciudad, los medidores que muevas o el día y la noche de la especie, y obedece y confirma las órdenes igual que un dispositivo.
- La API las guarda y las compara con el rango ideal de la especie: lechuga, tomate, fresa, albahaca, espinaca o pimentón.
- El asistente de IA combina un sistema experto, lógica difusa, modelos de aprendizaje automático y un agente reactivo para diagnosticar el cultivo, calcular su índice de salud y proponer acciones. De noche entiende que la planta descansa. Además aprende sin parar de las lecturas reales de cada especie: anticipa cuándo hará falta regar o ventilar en la próxima hora y reconoce lo poco habitual, sin saber de qué cuenta viene cada lectura. Un modelo nuevo solo reemplaza al vigente si lo mejora.
- La app (PWA instalable) muestra cada cultivo en vivo, dibujado con su forma, su planta y cada actuador encendido o apagado; envía alertas y permite encender la bomba, la luz, el ventilador, el humidificador o los dosificadores, o dejar que el agente lo haga en modo automático.
- Telegram te avisa aunque no tengas la app abierta: vinculas tu chat desde el perfil con un código de un solo uso,
eliges qué avisos recibir y consultas cómo van tus cultivos con
/estado.
Ocho diagramas generales muestran SmartPot completo. Cada uno se abre como SVG y se puede ampliar tanto como haga falta.
| Diagrama general | Qué muestra |
|---|---|
| Arquitectura completa | Los dispositivos, el borde, los ocho contenedores con sus módulos, puertos y redes, y los servicios externos |
| Operación completa | Toda la operación paso a paso: del registro a la lectura, la decisión de la IA, la orden al dispositivo y el aviso por Telegram |
| Entrega continua | Del commit al servidor: pruebas, QA de extremo a extremo, imágenes y despliegue |
| Linaje de los datos | De dónde sale cada dato, dónde se guarda y quién lo usa |
| Máquinas de estado | Sesión, dispositivo, comando, salud, modo automático, aprendizaje, Telegram y simulación de un cultivo virtual |
| Modelo de dominio | Entidades y contratos con sus relaciones |
| Recorrido de la app | Cada pantalla, qué pide a la API y quién responde |
| Decisión de la IA | De la lectura a la orden: diagnóstico, pronóstico, modelos, reglas, índice difuso y agente |
| Repositorio | Qué hace |
|---|---|
| SmartPot-Web | Aplicación web progresiva en React |
| SmartPot-API | API REST y puente MQTT en Spring Boot |
| SmartPot-AI | Asistente de IA en FastAPI y scikit-learn |
| SmartPot-Broker | Broker MQTT Mosquitto con una cuenta por cultivo |
| SmartPot-IoT | Firmware del dispositivo de un cultivo real, en un ESP32 o en Wokwi |
| SmartPot-DataGenerator | Simulador de los cultivos virtuales, la demo y las pruebas |
| SmartPot-DB · SmartPot-Cache · SmartPot-Mail | MongoDB, Redis y Mailpit endurecidos |
| .github | Entornos, despliegue, QA y documentación |
React 19 · TypeScript · Tailwind CSS · Java 21 · Spring Boot 4 · Python 3.13 · FastAPI · scikit-learn · MicroPython · Eclipse Mosquitto · MongoDB · Redis · Docker · Kubernetes · GitHub Actions
Lee la guía de contribución y la política de seguridad. Todo el código está bajo licencia MIT.
