Skip to content
@SmartPotTech

SmartPot

SmartPot is a software system designed for the management and automation of hydroponic gardens, focusing on tomato and lettuce crops.

SmartPot 🌱

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

Cómo funciona

  1. 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.
  2. La API las guarda y las compara con el rango ideal de la especie: lechuga, tomate, fresa, albahaca, espinaca o pimentón.
  3. 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. También mira dónde está cada cultivo: si al lugar le falta o le sobra sol para la especie, te recomienda moverlo, y con lluvia afuera no riega.
  4. La app (PWA instalable) muestra cada cultivo en vivo, dibujado en su lugar (bajo techo o al aire libre, con el clima de afuera), con su forma, su planta y cada actuador encendido o apagado. Cada actuador tiene su switch: enciendes la bomba, la luz ultravioleta, el ventilador, el humidificador o los dosificadores con un solo toque, o dejas que el agente lo haga en modo automático.
  5. Telegram te avisa aunque no tengas la app abierta: vinculas tu chat desde el perfil con un código de un solo uso y cada cultivo elige qué avisa, al instante o en resúmenes, con un resumen diario y los chats con los que lo compartes. Con /estado consultas cómo van tus cultivos.

La plataforma en diagramas

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

Repositorios

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

Tecnologías

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

Contribuir

Lee la guía de contribución y la política de seguridad. Todo el código está bajo licencia MIT.

Popular repositories Loading

  1. SmartPot-API SmartPot-API Public

    API REST y puente MQTT de SmartPot en Spring Boot 4 y Java 21

    Java 2

  2. SmartPot-IoT SmartPot-IoT Public

    Firmware MicroPython del dispositivo de un cultivo real de SmartPot (ESP32 o Wokwi) con MQTT sobre TLS

    Python 1

  3. SmartPot-Web SmartPot-Web Public

    PWA de SmartPot: monitoreo y control de cultivos hidropónicos en React

    TypeScript

  4. SmartPot-Proxy SmartPot-Proxy Public archive

    Obsoleto: reemplazado por SmartPot-Broker (MQTT). Archivado como referencia.

    Python

  5. SmartPot-DataGenerator SmartPot-DataGenerator Public

    Simulador de los cultivos virtuales de SmartPot por MQTT: clima real, día y noche o medidores manuales

    Python

  6. SmartPot-AI SmartPot-AI Public

    Asistente de IA de SmartPot: sistema experto, lógica difusa, ML y agente reactivo

    Python

Repositories

Showing 10 of 11 repositories

Top languages

Loading…

Most used topics

Loading…