♻️ Material Circularity Auditor

AI-Powered Construction Demolition Lifecycle Analysis

---

🚀 Overview

Material Circularity Auditor solves the complex problem of commercial demolition waste. By ingesting raw contractor text and unstructured demolition manifests, it uses gemini-3.5-flash to structure, analyze, and grade materials based on their "Circularity Potential"—suggesting recycling routes and calculating precise CO2 footprint savings.

✨ Key Features

• 🧠 Circularity AI Pipeline: Evaluates reuse potential across Timber, Steel, Concrete, Glass, Electrical, HVAC, and more.
• 🎨 Premium Glassmorphic UI: High-end React and Tailwind v4 dashboard to visualize saved carbon.
• ⚡ JSON Schema Enforcement: Guarantees deterministic grading logic from the Gemini LLM.

🛠 Tech Stack

• Frontend: React 19, TailwindCSS v4, Vite, Lucide Icons, Framer Motion.
• Backend: Node.js, Express, TypeScript.
• AI Core: @google/genai (Gemini API)

⚙️ Getting Started

1. Prerequisites

• Node.js (v24+)
• A Free Google Gemini API Key

2. Setup

Clone the repo and configure the environment:

git clone https://github.com/zfryrgnci/material-circularity-auditor.git
cd material-circularity-auditor
npm install

Create a .env file in the root directory:

GEMINI_API_KEY=your_free_api_key_here

3. Run Development Server

npm run dev

🧪 Testing Suite

Backed by a comprehensive Vitest testing infrastructure:

npm run test

🤝 Open Source

Created by Zafer Yorganci. Built for the future of green architecture!