FarmShield (AgriTech System)

is a comprehensive modern agricultural dashboard designed to track sensor readings, manage irrigation, detect crop diseases in real-time, and manage farm alerts.

This system was developed as part of our coursework to fulfill partial requirements for a subject in school.

System Components

• Frontend (farmshield_frontend): Built with React and Vite. It provides a modern, dark-themed responsive UI for monitoring the farm dashboard, sensors, irrigation, diseases, and alerts.
• Backend (farmshield_backend): Built with Python and Django. It handles API requests, database operations, and system logic.

Features

• Dashboard: Real-time overview of the farm's status.
• Sensors: Monitor temperature, humidity, and soil moisture levels.
• Irrigation: Control and track irrigation systems.
• Disease & Alerts: AI/Rules-based alerts for taking care of crop health.
• Farms: Manage different farm locations.

Guide To Run

To run the system locally, do the following.

• Clone this repository or download it as a ZIP file.
• When cloning the repository, follow these steps.

Install Required Software

• Node.js (for the frontend)
• Python 3.x (for the backend)

1. Setting up the Backend

Navigate to the backend directory and run the Django development server:

cd farmshield_backend

# (Optional but recommended) Create and activate a virtual environment
python -m venv venv
# On Windows:
venv\Scripts\activate
# On Mac/Linux:
source venv/bin/activate

# Install requirements (if you have a requirements.txt)
# pip install -r requirements.txt
# Otherwise, at minimum:
pip install django django-cors-headers

# Run database migrations
python manage.py migrate

# Start the development server
python manage.py runserver

The backend should now be running at http://127.0.0.1:8000/.

2. Setting up the Frontend

Open a new terminal, navigate to the frontend directory, install dependencies, and run the development server:

cd farmshield_frontend

# Install dependencies
npm install

# Start the Vite development server
npm run dev

The frontend should now be running locally (usually at http://localhost:5173/).

---

Acknowledgment

We are grateful to our instructors for their guidance and support throughout the development of this project.

This work reflects my learning journey as a programmer

Disclaimer

I do not own the images, names, information or references included in this project they are used purely as placeholders.
All trademarks, service marks, trade names, and other intellectual property rights belong to their respective owners.

Made with 💗 by Lurxdel