Surqo es una plataforma agroclimática de precisión diseñada para el campo colombiano. Conecta nodos de hardware de bajo costo instalados en fincas físicas con una nube inteligente que analiza microclima, calcula índices agronómicos y genera planes de acción específicos para cada cultivo mediante inteligencia artificial. El nombre viene de surco — la línea que traza el arado en la tierra — y representa la fusión entre la agricultura tradicional colombiana y la tecnología de vanguardia. La plataforma está dirigida a agricultores, cooperativas y técnicos agropecuarios que necesitan datos objetivos y recomendaciones concretas, sin requerir conocimientos técnicos avanzados.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ricardomb-tech/surqo/llms.txt
Use this file to discover all available pages before exploring further.
El problema
El 85% de los agricultores en Colombia toman decisiones de riego, fertilización y cosecha basadas en experiencia visual, sin datos objetivos. Las pérdidas por estrés hídrico, plagas y heladas ascienden a millones de pesos por cosecha que podrían evitarse con monitoreo continuo. El mercado colombiano cuenta con 4.9 millones de unidades productivas agropecuarias, pero solo el 2.3% usa tecnología de precisión — en gran parte porque las soluciones existentes de sensórica cuestan entre 500 USD por nodo, fuera del alcance de la mayoría de productores.La solución
Surqo resuelve esto con tres capas integradas:- Nodos IoT de bajo costo — Hardware ESP32 con sensores de temperatura del aire (DHT22), temperatura del suelo (DS18B20), humedad volumétrica (capacitivo v2.0) e índice UV (ML8511). Costo total por nodo: ~$15 USD. Autonomía ~2 semanas en deep sleep a ~10µA de consumo.
- Nube inteligente — Backend FastAPI en Fly.io que recibe lecturas vía MQTT TLS, calcula VPD en tiempo real (ecuación de Magnus), persiste en PostgreSQL y evalúa umbrales de alerta con cooldown Redis.
- IA accionable en español — Los análisis fusionan datos del sensor, pronóstico climático de 7 días (Open-Meteo) y KPIs agronómicos para generar recomendaciones específicas con Groq Llama 3.3 70B, con latencia menor a 1 segundo.
Características principales
Monitoreo de sensores en tiempo real
Lecturas cada 15 minutos desde nodos ESP32. Stream en vivo vía WebSocket al dashboard — sin polling. Métricas: temperatura del aire y suelo, humedad, índice UV, VPD y nivel de batería.
Análisis agronómico con IA
Motor multi-proveedor (Groq / Anthropic / Ollama) con prompts YAML versionados contextualizados para cultivos tropicales colombianos. Genera nivel de alerta (
ok, warning, critical), índice de estrés hídrico y recomendaciones priorizadas con ventana de tiempo.Alertas automáticas por umbral
Evaluación automática en cada lectura contra umbrales configurados (humedad suelo, temperatura, VPD, batería). Cooldown de 30 minutos en Redis para evitar spam. Envío de emails HTML vía Resend con acción recomendada.
Motor científico de KPIs: VPD, ETc, GDD
Cálculo de Déficit de Presión de Vapor (Magnus), Evapotranspiración del cultivo (Penman-Monteith × Kc), Grados Día de Crecimiento, déficit hídrico semanal, score de salud del suelo (0–100) y riesgo de plagas (%).
Planes
Surqo opera con un modelo freemium. El plan Free permite validar la plataforma con hardware real sin costo inicial; el plan Pro desbloquea capacidad ilimitada para fincas en operación continua.| Característica | Free | Pro |
|---|---|---|
| Fincas | 1 | Ilimitadas |
| Monitoreo en tiempo real | ✓ | ✓ |
| KPIs agronómicos (VPD, ETc, GDD) | ✓ | ✓ |
| Alertas automáticas por email | Ilimitadas | Ilimitadas |
| Análisis IA | 25 lifetime | Ilimitados |
| Tokens por análisis | 1.000 | 2.048 |
| Soporte prioritario | — | ✓ |
URLs de producción
El backend corre en Fly.io (región Dallas —
El Swagger interactivo (
dfw) con min_machines_running = 1 y auto_stop_machines = false. No hay cold starts — la API siempre tiene al menos una máquina activa.| Recurso | URL |
|---|---|
| Frontend | https://surqo.online |
| API Backend | https://surqo-api.fly.dev |
| Health check | https://surqo-api.fly.dev/health |
/docs) está deshabilitado en producción por seguridad. En desarrollo local está disponible en http://localhost:8000/docs.