RanchOps is an open-source, enterprise-capable ranch management platform built to modernize livestock operations while advancing sustainability and operational resilience. It combines an offline-first web application, an extensible backend, and an ML microservice to deliver predictive, data-driven farm management with strong privacy, interoperability, and SDG alignment.
One-line value proposition
A modular, offline-capable ranch management suite that blends livestock and workshop operations with predictive maintenance, IoT readiness, and sustainability metrics—designed for on‑farm reliability, regional scalability, and community-driven extensibility.
Unique differentiators
Offline-first PWA with local data sync: continue critical workflows with intermittent connectivity; syncs to Supabase/Postgres when online.
Built-in ML microservice: FastAPI + scikit-learn models for predictive maintenance and animal‑health signals, callable via a backend proxy.
IoT- and sensor-ready architecture: endpoints and data models designed for real‑time telemetry (water levels, GPS, feed dispensers).
SDG & sustainability focus: native metrics and dashboards that map operational data to SDG indicators (resource efficiency, emissions tracking).
Self-hostable + cloud-ready: deployable on local servers or cloud infra; data ownership remains with the ranch or organization.
Modular SQL schema and typed API contracts: easy to extend, migrate, and integrate with third‑party systems.
Core modules (detailed)
Livestock Management
Animal registry with lineage, biometric and health histories.
Pregnancy diagnostics, calving workflows, growth / weaning analytics.
Paddock/grazing allocation, rotation schedules and utilization reports.
Workshop & Vehicle Management
Vehicle registry, inspections, maintenance schedules and parts inventory.
Predictive maintenance recommendations from historical logs + ML risk scoring.
Fuel & cost tracking with audit trails.
Inventory & Procurement
Parts, feed and consumables inventory with reorder thresholds, suppliers and CSV export.
Procurement workflows and stock movement history.
Water Points & Resource Monitoring
Water source catalog, level history, pump health, automated alerts.
Integration points for sensors and automated actuators.
Reporting, Analytics & Dashboards
Time-series charts, cohort and trend analysis, customizable dashboards.
Scheduled report generation and CSV/PDF exports for compliance or partners.
Alerts & Notifications
Configurable alerting for health events, low stock, scheduled maintenance, and sensor anomalies.
Support for email, web push, and webhook integrations.
Security & Governance
Role-based access control, audit logs, secure auth via Supabase social/oauth providers.
CORS, security headers and TLS-ready deployment.
Architecture & stack
Frontend: React + TypeScript, Vite, Tailwind CSS, PWA/service worker.
Backend: Node.js + Express API with a lightweight ML proxy.
ML: Python FastAPI microservice, scikit-learn models, training scripts stored in repo.
Data: Postgres (Supabase) with versioned SQL migrations and typed API client.
Integration layers: Webhooks, external API connectors (weather, mapping, IoT brokers).
Extensibility & developer experience
Typed API client and clear data contracts to reduce integration friction.
Modular code organization and SQL schema for straightforward feature additions.
Local dev setup with npm scripts; CI pipeline and test coverage configured.
Clear hooks for adding new ML models, sensor adapters, or third‑party integration plugins.
Deployment & operations
Designed for hybrid deployment: local ranch server (low-latency, offline-first) or cloud-hosted multi-ranch setup.
Recommended deployment: containerized backend + ml-service, managed Postgres (or self-hosted), CDN for PWA assets.
Monitoring: integrate with Prometheus/Datadog and log shipping for production observability.
Primary use cases & benefits
Small to medium ranches that need resilience against poor connectivity.
Enterprises requiring multi-ranch oversight, compliance reports and predictive asset management.
NGOs and extension services tracking SDG-aligned outcomes across regions.
Integrators building IoT solutions for automated water/feeding systems.
Data ethics & privacy
Data ownership left with the ranch; self-hosting supported.
Exportable datasets and audit logs for transparency.
Minimal PII storage; role-based access to sensitive records.
Getting started (glance)
Clone repo, configure .env from .env.example, run frontend and backend with npm scripts.
Seed sample SQL to explore schemas and demo data.
Train or deploy ML models using provided training scripts.
Contribution & governance
Community-driven roadmap, issues and PRs welcome.
Contribution guidelines and code of conduct in repo.
Roadmap prioritizes SDG impact, feasibility and community demand.
License
MIT License — permissive for research, deployment and commercial use.