Skip to content

Mubashir21/FYP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

55 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐾 WildTechAlert

Live Website GitHub Telegram

An end-to-end wildlife detection and alerting platform that monitors animal presence through connected devices, providing real-time notifications and insights.

📋 Overview

WildTechAlert is a comprehensive platform designed to detect and monitor wildlife presence through a network of connected devices. The system provides real-time notifications, media evidence, and analytical insights, helping conservation efforts and wildlife management.

🔍 Key Features

  • Real-time Detection: Instant wildlife presence detection with image/video evidence
  • Automated Alerts: Customizable notifications via email and Telegram
  • Device Management: Register and monitor the health of connected sensor devices
  • User Roles: Admin panel for managing stakeholders and approvals
  • Analytics: Historical detection data, trends, and insights
  • Secure Authentication: User management powered by Supabase

🏗️ Architecture

  • Frontend: Next.js application hosted on Vercel
  • Backend: FastAPI service deployed on Heroku
  • Database: PostgreSQL via Supabase
  • Notification Services: Email (Resend API) and Telegram Bot

🚀 Getting Started

Prerequisites

Frontend Setup

# Navigate to frontend directory
cd frontend

# Install dependencies
npm install

# Start development server
npm run dev

Backend Setup

# Navigate to backend directory
cd backend

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Start the API server
uvicorn main:app --reload

⚙️ Environment Configuration

Create .env files in both frontend/ and backend/ directories based on the provided .env.example templates.

Required environment variables:

  • RESEND_API_KEY
  • SUPABASE_URL
  • SUPABASE_KEY
  • TELEGRAM_BOT_TOKEN
  • TELEGRAM_INVITE_LINK

🔗 Links

👨‍💻 Development

Developed by Mubashir Shoukat as a Final Year Project at the University of Nottingham Malaysia.

Supervisor: Dr. Tomas Maul


© 2025 WildTechAlert | All Rights Reserved

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors