Skip to content

Repository files navigation

VOIDFRAME2

AI-Powered DPR Intelligence & Evaluation Platform

Multi-agent evaluation engine for infrastructure DPRs with Next.js frontend, FastAPI AI backend, geospatial risk analysis, RAG search, and automated document intelligence.


Overview

VOIDFRAME2 is an intelligent platform for Detailed Project Report (DPR) analysis and decision support, designed for infrastructure, public sector, and project evaluation workflows.

The system combines:

  • Next.js Frontend for portal, dashboards and interactive workflows
  • FastAPI + Python AI Backend for autonomous DPR analysis
  • Multi-Agent LLM Evaluation (Engineering, Finance, Risk, Policy, Reviewer)
  • RAG + FAISS Semantic Search over uploaded DPRs
  • GIS & Risk Intelligence for terrain, flood, landslide and climate analysis
  • BoQ + Compliance Analysis for financial and policy checks
  • Annotated PDF Output highlighting identified issues

Core Idea

Upload a DPR → AI agents analyze it → risks/compliance/cost issues are surfaced → users receive:

  • AI evaluation report
  • Feasibility scoring
  • Compliance gaps
  • Cost anomalies
  • Risk simulations
  • GIS insights
  • Annotated DPR with flagged concerns
  • Interactive question-answering over the DPR

Key Features

Multi-Agent DPR Evaluation

Five specialized AI agents collaborate:

1. Engineer Agent

Analyzes:

  • Technical feasibility
  • Design adequacy
  • Slope, drainage, structural concerns
  • Engineering risks
  • Mitigation recommendations

2. Finance Agent

Evaluates:

  • BoQ and cost structures
  • Rate anomalies
  • Budget concentration risks
  • Cost benchmarking
  • Financial feasibility

3. Risk Agent

Quantifies:

  • Project execution risk
  • Terrain/weather uncertainty
  • Monte Carlo simulations
  • Cost/timeline overrun probability

4. Policy Agent

Checks:

  • Guideline compliance
  • Institutional readiness
  • Regulatory alignment
  • Implementation preparedness

5. Reviewer Agent

Synthesizes all agent outputs into:

  • Final feasibility recommendation
  • Consolidated scoring
  • Approval / conditional / reject recommendation
  • Executive summary

RAG + Semantic Search

Ask questions directly against uploaded DPRs:

  • DPR-grounded answers
  • FAISS vector retrieval
  • LLM synthesis
  • Optional web validation
  • Source-backed responses

Example:

“What contingency is budgeted for landslide mitigation?”

GIS + Spatial Intelligence

Integrated geospatial assessment:

  • Elevation analysis
  • Slope assessment
  • Landslide risk
  • Flood vulnerability
  • Infrastructure proximity mapping
  • Climate profile signals

Risk Simulation

Monte Carlo modeling:

  • P10 / P50 / P90 scenarios
  • Cost overrun probabilities
  • Schedule risk estimation
  • Contingency stress testing

Automated PDF Annotation

Outputs issue-marked DPR PDFs with:

  • Severity highlighting
  • Issue annotations
  • Review comments
  • Summary pages

Tech Stack

Frontend

  • Next.js
  • React
  • TypeScript
  • TailwindCSS
  • PostCSS

Backend

  • FastAPI
  • Python
  • LangChain
  • FAISS
  • Sentence Transformers
  • Groq / LLM inference

AI / Analytics

  • Multi-Agent Reasoning
  • Retrieval Augmented Generation (RAG)
  • Monte Carlo Simulation
  • Geospatial Risk Analysis
  • Cost Benchmarking
  • Compliance Scoring

Repository Structure

VOIDFRAME2/
│
├── src/                        # Next.js frontend
│   ├── app/
│   ├── components/
│   ├── hooks/
│   ├── services/
│   ├── lib/
│   └── types/
│
├── public/                     # static assets
│
├── backend/                    # FastAPI + AI engine
│   ├── api/
│   ├── ai/
│   ├── evaluations/
│   └── tests/
│
├── docs/
│   ├── Architecture/│ 
│   └── Backend/
│
├── package.json
├── next.config.ts
├── tsconfig.json
└── vercel.json

Architecture

End-to-End Flow

User uploads DPR PDF
      ↓
Frontend submits to FastAPI
      ↓
PDF Extraction
      ↓
FAISS Vector Store Build
      ↓
5 AI Agents Evaluate
      ↓
Additional Modules:
- GIS Engine
- Risk Simulation
- BoQ Parser
- Compliance Checks
- PDF Annotation
      ↓
Unified Evaluation Object
      ↓
Results returned to Frontend

Frontend Design System

The frontend uses a unified semantic UI system featuring:

  • Semantic color system
  • Typography scale
  • Spacing system
  • Reusable card system
  • Button variants
  • Glass/surface components
  • Shared layout patterns

Core reusable classes include:

page-wrapper
page-content
card-default
surface-glass
surface-glass-md
btn-primary
btn-secondary
btn-ghost
input-base
heading-xl → heading-sm
body-lg → body-xs

See documentation in /docs/style-guides.


API Endpoints

DPR Upload + Evaluation

POST /upload_dpr

Runs full evaluation pipeline.


Ask Questions Over DPR

POST /ask

RAG-powered question answering.


Re-run Evaluation

POST /evaluate_dpr

Health Check

GET /health

Local Development

Clone

git clone <repo-url>
cd VOIDFRAME2

Frontend Setup

npm install
npm run dev

Runs:

http://localhost:3000

Backend Setup

cd backend/Pyhton-Evaluation-Backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Run FastAPI:

uvicorn app:app --reload --port 8000

Backend:

http://localhost:8000

Environment Variables

Create .env

GROQ_API_KEY=your_key
SERPER_API_KEY=your_key
AGENT_MODEL=llama-3.1-8b-instant

Frontend variables (if needed):

NEXT_PUBLIC_API_URL=http://localhost:8000

Example Workflow

1 Upload DPR

User uploads PDF.


2 System Analyzes

Pipeline runs:

  • AI agent review
  • Risk quantification
  • GIS checks
  • Compliance scoring
  • Annotation

3 Receive Outputs

Returns:

{
  "evaluation": "AI report...",
  "issues": [],
  "gis_analysis": {},
  "risk_summary": {},
  "highlighted_pdf": "annotated.pdf"
}

Documentation

Architecture & Design

See:

docs/architecture/

Contains:

  • Design System
  • Visual Style Guide
  • UI Uniformity Implementation
  • Changes Summary

Python Backend Docs

See:

docs/backend/

Includes:

  • Backend Summary
  • Function Breakdown
  • Complete Code Flow
  • Quick Reference
  • Visual Architecture
  • Documentation Index

Current Modules

AI / Analysis

  • Multi-agent evaluation
  • RAG search
  • Vector search
  • Compliance engine
  • BoQ parsing
  • Monte Carlo simulation
  • GIS engine
  • PDF annotation

Frontend Modules

  • Portal dashboards
  • Upload workflows
  • Chat assistant
  • Result visualizations
  • Unified UI system

Development Principles

This codebase follows:

  • Modular architecture
  • Service-oriented backend layers
  • Shared design system
  • Reusable component patterns
  • Semantic styling
  • Documentation-first development

Roadmap

Planned/possible extensions:

  • Autonomous DPR review agents
  • Multi-DPR comparative analysis
  • Workflow approvals
  • Government scheme benchmark engine
  • Agentic remediation suggestions
  • Procurement intelligence
  • Predictive project failure scoring

Scripts

Common commands:

Frontend

npm run dev
npm run build
npm run lint

Backend

uvicorn app:app --reload
pytest

Contributing

Suggested workflow:

git checkout -b feature/my-feature

Follow:

  • unified design system
  • backend layered architecture
  • linting rules
  • documentation updates with changes

Status

Current focus:

  • AI DPR Evaluation Platform
  • Frontend + FastAPI integration
  • Multi-agent infrastructure intelligence

Vision

VOIDFRAME2 aims to turn DPR review from a manual document-heavy exercise into an AI-assisted intelligence workflow for faster, better infrastructure decisions.


Built with:

  • Next.js
  • FastAPI
  • LangChain
  • FAISS
  • Multi-Agent AI

About

.2nd version of void frame

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages