Skip to content

keenalise/HydroGuard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

21 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

HydroVerify Nepal

Advanced AI-powered review and certification platform for hydroelectric projects in Nepal

HydroVerify Nepal is a comprehensive solution that helps investors make faster, more informed decisions about hydroelectric development projects. By automating document analysis and compliance verification, we bridge the gap between developers and investors with transparency and speed.


πŸ“‹ Table of Contents


🌊 Overview

Nepal possesses an estimated hydroelectric potential of 42,000 megawatts, making it a global leader in renewable energy opportunity. However, evaluating hydroelectric projects requires rigorous analysis of complex technical documentation, environmental compliance, and community engagement records.

HydroVerify Nepal automates this critical process by:

  • Analyzing developer reports against international standards
  • Verifying environmental and social compliance
  • Extracting and validating project data
  • Generating investor-ready certification documents

What once took weeks of manual review now happens in minutes.


🎯 Problem Statement

Investors evaluating hydroelectric projects face significant challenges:

  1. Volume β€” Dozens of project proposals arrive monthly, each with hundreds of pages of documentation
  2. Complexity β€” Multiple compliance frameworks (IFC standards, environmental protocols, community assessments)
  3. Time β€” Manual document review is time-intensive and prone to human error
  4. Standardization β€” Inconsistent analysis across different projects creates risk

✨ Solution

HydroVerify Nepal provides a standardized, automated platform that:

  • Uploads developer reports and supporting documents
  • Analyzes documents against international compliance standards
  • Verifies environmental and social requirements
  • Generates clear, investor-ready certificates
  • Outputs structured project data for decision-making

πŸš€ Key Features

  • Document Upload & Processing β€” Support for PDF, DOCX, and image formats
  • IFC Compliance Verification β€” Checks against Performance Standards 1-8
  • Environmental Assessment β€” Analyzes ecological impact documentation
  • Community Satisfaction Review β€” Evaluates stakeholder engagement records
  • Automated Scoring β€” Generates compliance scores (0-100)
  • Certificate Generation β€” Creates investor-ready verification documents
  • Executive Summary β€” Provides clear, actionable insights
  • Risk Assessment β€” Flags critical compliance gaps
  • Multi-Document Comparison β€” Cross-references related project documents

πŸ› οΈ Tech Stack

Frontend

  • Next.js 14 β€” React framework with App Router
  • TypeScript β€” Type-safe development
  • Tailwind CSS β€” Utility-first styling
  • Radix UI β€” Accessible component library
  • Lucide Icons β€” Modern icon system

Backend

  • Next.js API Routes β€” Serverless backend
  • Node.js β€” Runtime environment

AI & Analysis

  • Google Generative AI β€” Document analysis and text extraction
  • Image Analysis β€” Visual document processing
  • NLP Processing β€” Sentiment and compliance analysis

Development Tools

  • pnpm β€” Fast package manager
  • ESLint β€” Code linting
  • PostCSS β€” CSS processing

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • pnpm or npm
  • API keys for Google Generative AI

Installation

  1. Clone the repository

    git clone https://github.com/Gobler-code/hydroverify-nepal.git
    cd hydroverify-nepal
  2. Install dependencies

    pnpm install
  3. Set up environment variables Create a .env.local file:

    NEXT_PUBLIC_GOOGLE_API_KEY=your_google_api_key
  4. Run the development server

    pnpm dev
  5. Open your browser Navigate to http://localhost:3000

Build for Production

pnpm build
pnpm start

πŸ“ Project Structure

hydroverify-nepal/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ api/
β”‚   β”‚   β”œβ”€β”€ analyze-image/         # Image analysis endpoint
β”‚   β”‚   β”œβ”€β”€ check-ifc/             # IFC compliance verification
β”‚   β”‚   β”œβ”€β”€ compare-docs/          # Document comparison
β”‚   β”‚   └── process-document/      # Document extraction & processing
β”‚   β”œβ”€β”€ globals.css                # Global styles
β”‚   β”œβ”€β”€ layout.tsx                 # Root layout
β”‚   └── page.tsx                   # Main page
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ certificate-section.tsx    # Compliance certificate display
β”‚   β”œβ”€β”€ hero-header.tsx            # Landing section
β”‚   β”œβ”€β”€ upload-cards-grid.tsx      # Main upload interface
β”‚   β”œβ”€β”€ upload-card.tsx            # Individual upload card
β”‚   β”œβ”€β”€ audit-button.tsx           # Audit trigger
β”‚   β”œβ”€β”€ dashboard-footer.tsx       # Footer
β”‚   β”œβ”€β”€ pdf-preview-dialog.tsx     # Document preview
β”‚   └── ui/                        # Reusable UI components
β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ document-processing.ts     # Document handling
β”‚   β”œβ”€β”€ gemini-helpers.ts          # AI API integration
β”‚   β”œβ”€β”€ google-image-analysis.ts   # Image processing
β”‚   └── utils.ts                   # Utility functions
β”œβ”€β”€ hooks/
β”‚   β”œβ”€β”€ use-mobile.ts              # Mobile detection
β”‚   └── use-toast.ts               # Toast notifications
β”œβ”€β”€ types/
β”‚   └── pdf-parse.d.ts             # Type definitions
β”œβ”€β”€ public/                        # Static assets
β”œβ”€β”€ styles/                        # Global styles
β”œβ”€β”€ next.config.mjs                # Next.js configuration
β”œβ”€β”€ tsconfig.json                  # TypeScript configuration
└── package.json                   # Dependencies


πŸ”„ Workflow

  1. Upload β†’ Developer submits hydroelectric project documentation
  2. Extract β†’ System extracts and processes document text
  3. Analyze β†’ Compliance against IFC standards, environmental requirements
  4. Verify β†’ Cross-reference documents and assess consistency
  5. Score β†’ Generate compliance scores for each category
  6. Certify β†’ Create investor-ready verification certificate
  7. Export β†’ Download final report with recommendations

πŸ“Š Compliance Standards

HydroVerify Nepal verifies compliance with:

  • IFC Performance Standards (PS1-PS8)

    • Environmental and Social Assessment
    • Labor and Working Conditions
    • Resource Efficiency and Pollution Prevention
    • Community Health, Safety and Security
    • Land Acquisition and Involuntary Resettlement
    • Biodiversity Conservation and Sustainable Management
    • Indigenous Peoples
    • Cultural Heritage
  • Nepal Environmental Standards

  • World Bank Guidelines

  • International Hydropower Association Standards


πŸ‘₯ Team

Inspired Ones

Name GitHub
Uparjan Gautam @Gobler-code
Bibek Sharma @BibekSharma04
Prajwal Bhandari @keenalise

🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“ License

This project is licensed under the MIT License β€” see the LICENSE file for details.


πŸ“§ Contact & Support

For questions, feedback, or partnership inquiries:

  • Team: Inspired Ones
  • Project: HydroVerify Nepal β€” Empowering Investment in Hydroelectric Energy

🎯 Future Roadmap

  • Multi-language support (Nepali, English, Hindi)
  • Real-time project monitoring dashboard
  • Integration with geological survey data
  • Cost-benefit analysis module
  • Community engagement tracking
  • Automated risk scoring
  • Investor portal with filtered project listings

Made By Inspired Ones

About

Junction X Kathmandu Hackathon

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors