Skip to content

linfordlee14/rhinoshield

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rhinoshield

Decentralized AI & DePIN for Anti-Poaching Protection - W3Node Hackathon 2026

RhinoShield

RhinoShield is a DePIN node simulator with Lilypad AI integration for real-time threat detection (e.g., gunshots) in wildlife reserves.

Project Structure

  • backend/: FastAPI application, AI simulator, and node background tasks.
  • frontend/: React/Next.js dashboard (to be implemented).
  • contracts/: Smart contracts for decentralized verification.

Backend Setup & Execution

Prerequisites

  • Python 3.11 or higher
  • pip (Python package installer)

1. Navigate to the project root

cd /Users/user/Downloads/Rhinoshield

2. Create and activate a virtual environment

It is highly recommended to use a virtual environment to manage dependencies:

# Create the virtual environment
python3 -m venv venv

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

3. Install dependencies

pip install -r backend/requirements.txt

4. Run the backend

You can run the backend in two ways:

Option A: Using Python directly (from project root)

export PYTHONPATH=$PYTHONPATH:.
python3 backend/main.py

Option B: Using Uvicorn directly

uvicorn backend.main:app --host 0.0.0.0 --port 8000 --reload

5. Verify the backend is running

Once the backend is started, you can verify it using the following links:

Features

  • Node Simulator: Simulates 5 ranger sensor nodes in South Africa.
  • AI Integration: Mock Lilypad AI analysis of audio events (20% gunshot detection rate).
  • Historical Data: Automatically generates 500 historical threat records on startup for dashboard visualization.
  • Real-time Events: Generates a new random event every 10 seconds. (Initial commit: RhinoShield DePIN for W3Node Hackathon 2026)

About

Decentralized AI & DePIN for Anti-Poaching Protection - W3Node Hackathon 2026

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors