Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
139 changes: 82 additions & 57 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,86 +1,111 @@
# HackToFuture 4.0 — Template
<div align="center">
<img src="https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/NextJS-Dark.svg" width="50" />
<img src="https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/Python-Dark.svg" width="50" />
<img src="https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/TensorFlow-Dark.svg" width="50" />
<h1 style="color: #34d399; font-weight: bold; margin-top: 15px;">🌐 NeuroMesh</h1>
<p><b>AI-Powered Disaster Response & Telemetry Validation Network</b></p>

[![HackToFuture 4](https://img.shields.io/badge/HackToFuture-4-blueviolet?style=for-the-badge)](#)
[![Status](https://img.shields.io/badge/Status-Active-success?style=for-the-badge)](#)
</div>

Welcome to your official HackToFuture 4 repository.
<br/>

This repository template will be used for development, tracking progress, and final submission of your project. Ensure that all work is committed here within the allowed hackathon duration.
## 🚨 Problem Statement / Idea

---
**What is the problem?**
During critical disasters (earthquakes, structural collapses, gas leaks), first responders are blinded by chaotic data, broken communication lines, and false alarms. Misallocating rescue teams to a "false alarm" while a real crisis unfolds costs lives.

### Instructions for the teams:
**Why is it important?**
The "Golden Day" (first 24 hours) is crucial for survival. Emergency response systems need filtered, validated, and highly accurate situation reports (SitReps) to deploy Urban Search and Rescue (USAR) teams safely and dynamically.

- Fork the Repository and name the forked repo in this convention: hacktofuture4-team_id (for eg: hacktofuture4-A01)
**Who are the target users?**
- National Disaster Response Force (NDRF) / FEMA
- Emergency Command Centers
- First Responders & Hazmat (CBRN) Teams

---

## Rules

- Work must be done ONLY in the forked repository
- Only Four Contributors are allowed.
- After 36 hours, Please make PR to the Main Repository. A Form will be sent to fill the required information.
- Do not copy code from other teams
- All commits must be from individual GitHub accounts
- Please provide meaningful commits for tracking.
- Do not share your repository with other teams
- Final submission must be pushed before the deadline
- Any violation may lead to disqualification

---
## 💡 Proposed Solution

# The Final README Template
**What are we building?**
**NeuroMesh** is a comprehensive hardware-software simulation platform representing a deployed mesh network of environmental sensors. It feeds raw telemetry (seismic vibrations, gas PPM, PIR survivor movement) into a multi-stage AI pipeline.

## Problem Statement / Idea
**How does it solve the problem?**
Raw data is processed by specialized ML models (CNNs for seismic, Random Forests for gas). Crucially, an **Isolation Forest** validator checks the aggregated outputs to flag hardware glitches or false alarms. If authenticated, an LLM (Mistral) generates an actionable, military-grade Situation Report (SitRep).

Clearly describe the problem you are solving.

- What is the problem?
- Why is it important?
- Who are the target users?
**What makes your solution unique?**
- **False Alarm Filtration:** We don't just alert; we authenticate the crisis using anomaly detection, saving wasted rescue trips.
- **Multi-Modal AI:** Specialized models handle specific sensor outputs before fusing data into LangGraph.
- **Interactive UI:** A Next.js Turbopack dashboard visualizes node status with real-time Framer Motion animations.

---

## Proposed Solution

Explain your approach:
## 🚀 Features

- What are you building?
- How does it solve the problem?
- What makes your solution unique?
- 🟢 **Live Telemetry Dashboard:** An interactive Web GIS UI plotting mesh nodes and live status.
- 🧠 **Multi-Model Inference:**
- Seismic Activity Classification (Keras/TensorFlow)
- Hazardous Gas Prediction (Scikit-Learn Random Forest)
- Survivor Count Estimation (Scikit-Learn)
- 🛡️ **Crisis Validator (Isolation Forest):** Identifies erratic sensor behavior or false positives.
- ⚡ **Automated LLM SitReps:** LangGraph orchestration to output clear "Recommended Actions" and "Threat Levels".
- 📡 **Simulated LoRaWAN Network:** Fallback communication visualization for unconnected zones.

---

## Features
## 🛠️ Tech Stack

List the core features of your project:
<details>
<summary><b>Click to expand technical details</b></summary>
<br/>

- Feature 1
- Feature 2
- Feature 3
- **Frontend:** Next.js 16 (App Router, Turbopack), React, TailwindCSS, Framer Motion, Lucide Icons
- **Backend / AI Pipeline:** Python 3.13, LangGraph
- **Machine Learning:** Scikit-Learn, TensorFlow/Keras, Pandas, NumPy
- **Generative AI:** Mistral / LLM (SitRep Generation)
- **Data:** CSV-based robust simulated environments (`gas_data.csv`, `seismic_data.csv`, `survivor_data.csv`)

---

## Tech Stack

Mention all technologies used:

- Frontend:
- Backend:
- Database:
- APIs / Services:
- Tools / Libraries:
</details>

---

## Project Setup Instructions
## ⚙️ Project Setup Instructions

Provide clear steps to run your project:

```bash
# Clone the repository
git clone <repo-link>

# Install dependencies
...

# Run the project
...
# 1. Clone the repository
git clone https://github.com/haashid/hacktofuture4-I03.git
cd hacktofuture4-I03

# ---------------------------------------------
# FRONTEND (Next.js Dashboard)
# ---------------------------------------------
cd dashboard
npm install

# Run the Next.js development server
npm run dev

# ---------------------------------------------
# AI PIPELINE (Python Environment)
# ---------------------------------------------
# Open a new terminal and navigate to the project root
cd ..

# Create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate

# Install AI dependencies
pip install scikit-learn tensorflow pandas numpy langgraph

# Run the AI Pipeline
python pipeline/langgraph_pipeline.py
```

<br/>
<div align="center">
<sub>Built with ❤️ for HackToFuture 4</sub>
</div>
41 changes: 41 additions & 0 deletions dashboard/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.

# dependencies
/node_modules
/.pnp
.pnp.*
.yarn/*
!.yarn/patches
!.yarn/plugins
!.yarn/releases
!.yarn/versions

# testing
/coverage

# next.js
/.next/
/out/

# production
/build

# misc
.DS_Store
*.pem

# debug
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-debug.log*

# env files (can opt-in for committing if needed)
.env*

# vercel
.vercel

# typescript
*.tsbuildinfo
next-env.d.ts
5 changes: 5 additions & 0 deletions dashboard/AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
<!-- BEGIN:nextjs-agent-rules -->
# This is NOT the Next.js you know

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
<!-- END:nextjs-agent-rules -->
1 change: 1 addition & 0 deletions dashboard/CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
@AGENTS.md
36 changes: 36 additions & 0 deletions dashboard/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).

## Getting Started

First, run the development server:

```bash
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
```

Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.

You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.

This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.

## Learn More

To learn more about Next.js, take a look at the following resources:

- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.

You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!

## Deploy on Vercel

The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.

Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
18 changes: 18 additions & 0 deletions dashboard/eslint.config.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
import { defineConfig, globalIgnores } from "eslint/config";
import nextVitals from "eslint-config-next/core-web-vitals";
import nextTs from "eslint-config-next/typescript";

const eslintConfig = defineConfig([
...nextVitals,
...nextTs,
// Override default ignores of eslint-config-next.
globalIgnores([
// Default ignores of eslint-config-next:
".next/**",
"out/**",
"build/**",
"next-env.d.ts",
]),
]);

export default eslintConfig;
13 changes: 13 additions & 0 deletions dashboard/next.config.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
import type { NextConfig } from "next";
import path from "path";

const nextConfig: any = {
/* config options here */
experimental: {
turbopack: {
root: path.join(__dirname),
}
}
};

export default nextConfig;
Loading